Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tindakan langkah yang didukung untuk dokumen alur kerja Anda

Bagian ini mencakup detail untuk tindakan langkah yang didukung Pembuat Gambar.

Tabel berikut menunjukkan tahapan alur kerja mana yang mendukung setiap tindakan langkah. Tanda centang (X) menunjukkan bahwa Anda dapat menggunakan tindakan langkah pada tahap itu. Image Builder membatasi beberapa tindakan untuk tahapan tertentu: ExecuteComponents ke tahap pembuatan dan pengujian, CollectImageScanFindings ke tahap pengujian, danDistributeImage,ModifyImageAttributes,ApplyImageConfigurations, dan DistributeContainerImage ke tahap distribusi. Anda dapat menggunakan setiap tindakan lain dalam tahap apa pun.

ApplyImageConfigurations

Gunakan tindakan langkah ini untuk menerapkan berbagai konfigurasi dan integrasi ke AMI terdistribusi, seperti konfigurasi lisensi, konfigurasi template peluncuran, konfigurasi ekspor S3, konfigurasi Peluncuran Cepat EC2, dan konfigurasi parameter Manajer Sistem. Konfigurasi berlaku untuk gambar terdistribusi hanya di akun sumber, kecuali untuk konfigurasi parameter SSM yang dapat diterapkan lintas akun.

Batas Waktu Default: 360 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini. In distributedImages.$ put diperlukan. Baris yang tersisa menggambarkan bidang dalam setiap item configurations array.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: ApplyImageConfigurations
  action: ApplyImageConfigurations
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages
    configurations:
      - region: us-west-2
        licenseConfigurationArns:
          - arn:aws:license-manager:us-west-2:111122223333:license-configuration:lic-example

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.ApplyImageConfigurationsStep.configuredImages

BootstrapInstanceForContainer

Tindakan langkah ini menjalankan skrip layanan untuk mem-bootstrap instance dengan persyaratan minimum untuk menjalankan alur kerja kontainer. Image Builder menggunakan API Manajer Sistem untuk menjalankan skrip ini. sendCommand Untuk informasi selengkapnya, lihat J AWS Systems Manager alankan Perintah.

Batas Waktu Default: 60 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: ContainerBootstrapStep
  action: BootstrapInstanceForContainer
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.ContainerBootstrapStep.status

CollectImageMetadata

Tindakan langkah ini hanya berlaku untuk alur kerja build.

EC2 Image Builder menjalankan Agen AWS Systems Manager (Manajer Sistem) pada instans EC2 yang diluncurkan untuk membangun dan menguji gambar Anda. Image Builder mengumpulkan informasi tambahan tentang instance yang digunakan selama fase build dengan System Manager Inventory. Informasi ini mencakup nama dan versi sistem operasi (OS), serta daftar paket dan versi masing-masing seperti yang dilaporkan oleh sistem operasi Anda.

Batas Waktu Default: 30 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Image Builder mengembalikan semua sumber daya Manajer Sistem yang dibuat selama langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: CollectMetadataStep
  action: CollectImageMetadata
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.CollectMetadataStep.osVersion

CollectImageScanFindings

Jika Amazon Inspector diaktifkan untuk akun Anda dan pemindaian gambar diaktifkan untuk pipeline Anda, tindakan langkah ini mengumpulkan temuan pemindaian gambar yang dilaporkan oleh Amazon Inspector untuk instance pengujian Anda. Tindakan langkah ini tidak tersedia untuk alur kerja build.

Batas Waktu Default: 120 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: CollectFindingsStep
  action: CollectImageScanFindings
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.CollectFindingsStep.status

CreateImage

Tindakan langkah ini membuat gambar dari instance yang sedang berjalan dengan Amazon EC2 CreateImage API. Selama proses pembuatan, tindakan langkah menunggu seperlunya untuk memverifikasi bahwa sumber daya telah mencapai status yang benar sebelum dilanjutkan.

Batas Waktu Standar: 720 menit

Waktu Batas Maks: 3 hari (259.200 detik)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: CreateImageFromInstance
  action: CreateImage
  onFailure: Abort
  inputs:
      instanceId.$: "i-1234567890abcdef0"

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.CreateImageFromInstance.imageId

CreateImageFromIso

Gunakan tindakan langkah ini untuk membuat Amazon Machine Image (AMI) dari image disk ISO pada instance build. Gunakan dalam alur kerja build ketika sumber Anda adalah file ISO daripada AMI dasar. Image Builder mengonversi ISO ke AMI dan menunggu sumber daya mencapai status yang diperlukan sebelum dilanjutkan.

Batas Waktu Standar: 720 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: CreateImageFromIsoStep
  action: CreateImageFromIso
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.CreateImageFromIsoStep.amiName

DistributeContainerImage

Gunakan tindakan langkah ini untuk mendistribusikan image wadah yang dibuat tahap build ke repositori Amazon ECR di Wilayah target yang ditentukan untuk gambar. Gunakan tindakan ini dalam alur kerja distribusi untuk gambar container (DOCKER). Ini berfungsi sebagai mitra gambar wadah untuk. DistributeImage

Tindakan langkah ini menjalankan perintah Manajer Sistem pada instance build untuk mendorong image container. Instance harus memiliki Docker dan yang AWS CLI diinstal. Untuk informasi selengkapnya, lihat BootstrapInstanceForContainer.

Batas Waktu Default: 120 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: DistributeContainer
  action: DistributeContainerImage
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.DistributeContainer.status

DistributeImage

Tindakan langkah ini mendistribusikan AMI ke Daerah target dan akun yang Anda tentukan. Ini menggunakan konfigurasi distribusi dari CreateImage atau CreateImagePipeline permintaan Anda, atau pengaturan distribusi kustom dalam alur kerja yang mengesampingkan konfigurasi default.

Batas Waktu Default: 360 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: DistributeImage
  action: DistributeImage
  onFailure: Abort
  inputs:
    distributions:
      - region.$: "$.parameters.SourceRegion"
        description: "AMI distribution to source region"
        amiTags:
          DistributionTest: "SourceRegion"
          WorkflowStep: "DistributeToSourceRegion"
          BuildDate: "{{imagebuilder:buildDate:yyyyMMHHss}}"
          BuildVersion: "{{imagebuilder:buildVersion}}"
		  

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.DistributeImageStep.distributedImages

ExecuteComponents

Tindakan langkah ini menjalankan komponen yang ditentukan dalam resep untuk gambar saat ini yang sedang dibangun. Alur kerja build menjalankan komponen build pada instance build. Alur kerja pengujian hanya menjalankan komponen pengujian pada instance pengujian.

Image Builder menggunakan API Manajer Sistem untuk menjalankan komponen. sendCommand Untuk informasi selengkapnya, lihat J AWS Systems Manager alankan Perintah.

Batas Waktu Standar: 720 menit

Waktu Batas Maks: 1 hari (24 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: ExecComponentsStep
  action: ExecuteComponents
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.ExecComponentsStep.status

ExecuteStateMachine

Tindakan langkah ini memulai eksekusi mesin AWS Step Functions status dari alur kerja Image Builder. Image Builder menggunakan Step Functions StartExecution API untuk memulai mesin status dan menunggu sampai selesai. Ini berguna untuk mengintegrasikan alur kerja yang kompleks, validasi kepatuhan, atau proses sertifikasi ke dalam pipeline pembuatan gambar Anda.

Untuk informasi selengkapnya, lihat Mem pelajari mesin status di Fungsi Langkah di Panduan AWS Step Functions Pengembang.

Batas Waktu Default: 6 jam

Waktu Batas Maks: 24 jam

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Diperlukan izin IAM

Peran eksekusi kustom Anda harus memiliki izin berikut untuk menggunakan tindakan langkah ini:

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: ValidateImageCompliance
  action: ExecuteStateMachine
  timeoutSeconds: 3600
  onFailure: Abort
  inputs:
    stateMachineArn: arn:aws:states:us-west-2:111122223333:stateMachine:ImageComplianceValidation
    input: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-west-2",
        "complianceLevel": "high",
        "requiredScans": ["cve", "benchmark", "configuration"]
      }

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.ValidateImageCompliance.executionArn

LaunchInstance

Gunakan tindakan langkah ini untuk meluncurkan instance di Anda Akun AWS. Tindakan menunggu hingga instance memenuhi kondisi pemeriksaan kesehatan yang ditentukan dan agen Manajer Sistem berjalan sebelum melanjutkan ke langkah berikutnya. Tindakan peluncuran menggunakan pengaturan dari sumber daya konfigurasi resep dan infrastruktur Anda. Misalnya, jenis instance yang akan diluncurkan berasal dari konfigurasi infrastruktur. Outputnya adalah ID instance dari instance yang diluncurkan.

In waitFor put mengonfigurasi kondisi yang memenuhi persyaratan penyelesaian langkah. In healthCheck put menentukan tingkat validasi kesehatan instans EC2 yang harus dilalui sebelum langkah dilanjutkan.

Batas Waktu Default: 75 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Untuk instans build, rollback melakukan tindakan yang telah Anda konfigurasikan di sumber daya konfigurasi infrastruktur. Secara default, instance build dihentikan jika pembuatan gambar gagal. Namun, ada pengaturan dalam konfigurasi infrastruktur untuk menjaga instance build untuk pemecahan masalah.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: LaunchStep
  action: LaunchInstance
  onFailure: Abort
  inputs:
    healthCheck: "RUNNING"
    waitFor: ssmAgent

Gunakan output dari tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Gunakan tindakan langkah ini untuk memodifikasi atribut AMI terdistribusi, seperti izin peluncuran dan atribut AMI lainnya. Ini beroperasi pada AMI yang telah didistribusikan ke Daerah dan akun target.

Batas Waktu Default: 120 menit

Waktu Batas Maks: 180 menit (3 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: ModifyImageAttributes
  action: ModifyImageAttributes
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages
    attributes:
      - region: us-west-2
        launchPermission:
          userIds:
            - "111122223333"

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.ModifyImageAttributesStep.modifiedImages

RegisterImage

Tindakan langkah ini mendaftarkan Amazon Machine Image (AMI) baru menggunakan Amazon EC2 RegisterImage API. Ini memungkinkan Anda untuk membuat AMI dari snapshot yang ada atau set snapshot, menentukan berbagai atribut gambar.

Batas Waktu Standar: 540 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Masukan: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Diperlukan izin IAM

Peran eksekusi kustom Anda harus memiliki izin berikut untuk menggunakan tindakan langkah ini:

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: RegisterNewImage
  action: RegisterImage
  onFailure: Abort
  inputs:
    architecture: "x86_64"
    bootMode: "uefi"
    blockDeviceMapping:
      - DeviceName: "/dev/sda1"
        Ebs:
          SnapshotId: "snap-1234567890abcdef0"
          VolumeSize: 100
          VolumeType: "gp3"
    rootDeviceName: "/dev/sda1"
    virtualizationType: "hvm"

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.RegisterNewImage.imageId

Contoh dengan tag SnapshotId dari langkah lain dan snapshot yang disertakan dalam AMI yang dihasilkan

- name: CreateSnapshot
  action: RunCommand
  onFailure: Abort
  inputs:
    instanceId: "i-1234567890abcdef0"
    documentName: "AWS-RunShellScript"
    parameters:
      commands:
        - "aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description 'Snapshot for AMI' --query 'SnapshotId' --output text"

- name: RegisterImageFromSnapshot
  action: RegisterImage
  onFailure: Abort
  inputs:
    architecture: "x86_64"
    bootMode: "uefi"
    blockDeviceMapping:
      - DeviceName: "/dev/sda1"
        Ebs:
          SnapshotId.$: "$.stepOutputs.CreateSnapshot.output[0]"
          VolumeSize: 100
          VolumeType: "gp3"
    includeSnapshotTags: true
    rootDeviceName: "/dev/sda1"
    virtualizationType: "hvm"

RunCommand

Tindakan langkah ini menjalankan dokumen perintah untuk alur kerja Anda. Image Builder menggunakan API Manajer Sistem untuk menjalankannya untuk Anda. sendCommand Untuk informasi selengkapnya, lihat J AWS Systems Manager alankan Perintah.

Batas Waktu Standar: 720 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: RunCommandDoc
  action: RunCommand
  onFailure: Abort
  inputs:
    documentName: SampleDocument
    parameters:
        osPlatform: 
          - "linux"
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.RunCommandDoc.status

RunSysPrep

Tindakan langkah ini menggunakan API Manajer Sistem untuk menjalankan AWSEC2-RunSysprep dokumen untuk instans Windows sebelum instance build dimatikan untuk snapshot. sendCommand Tindakan ini mengikuti praktik AWS terbaik untuk pengerasan dan pembersihan gambar .

Batas Waktu Default: 60 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: RunSysprep
  action: RunSysPrep
  onFailure: Abort
  inputs:
      instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.RunSysprep.status

SanitizeInstance

Tindakan langkah ini menjalankan skrip sanitasi yang direkomendasikan untuk instans Linux sebelum instance build dimatikan untuk snapshot. Skrip sanitize membantu memastikan bahwa gambar akhir mengikuti praktik terbaik keamanan, dan artefak atau pengaturan build yang tidak boleh dibawa ke snapshot Anda dihapus. Untuk informasi selengkapnya tentang skrip, lihatDiperlukan pembersihan pasca pembangunan. Tindakan langkah ini tidak berlaku untuk gambar kontainer.

Image Builder menggunakan API Manajer Sistem untuk menjalankan skrip ini. sendCommand Untuk informasi selengkapnya, lihat J AWS Systems Manager alankan Perintah.

Batas Waktu Default: 60 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: SanitizeStep
  action: SanitizeInstance
  onFailure: Abort
  inputs:
      instanceId: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.SanitizeStep.status

TerminateInstance

Tindakan langkah ini mengakhiri instance yang Anda tentukan dengan instanceId input. Secara default, ini memulai penghentian dan pindah ke langkah berikutnya tanpa menunggu. Proses latar belakang menangani pembersihan jika penghentian menemukan kesalahan layanan EC2. Untuk menunggu penghentian penuh sebelum melanjutkan, atur waitForTermination input ketrue.

Batas Waktu Default: 30 menit

Waktu Batas Maks: 720 menit (12 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tidak ada output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: TerminateInstance
  action: TerminateInstance
  onFailure: Continue
  inputs:
      instanceId.$: i-1234567890abcdef0
      waitForTermination: false

WaitForAction

Tindakan langkah ini menjeda alur kerja yang sedang berjalan dan menunggu untuk menerima tindakan eksternal dari tindakan SendWorkflowStepAction API Pembuat Gambar. Langkah ini menerbitkan EventBridge acara ke bus EventBridge acara default Anda dengan tipe detailEC2 Image Builder Workflow Step Waiting. Langkah ini juga dapat mengirim pemberitahuan SNS jika Anda memberikan ARN Topik SNS, atau memanggil fungsi Lambda secara asinkron jika Anda memberikan nama fungsi Lambda.

Bagaimana jeda dan resume bekerja

Saat WaitForAction langkah berjalan, Image Builder menetapkan status langkah ke WAITING dan menerbitkan EventBridge peristiwa (tipe detailEC2 Image Builder Workflow Step Waiting). Jika Anda memberikansnsTopicArn, itu juga mengirimkan pemberitahuan Amazon SNS. Jika Anda menyediakanlambdaFunctionName, itu memanggil fungsi itu secara asinkron. Alur kerja tetap dijeda sampai salah satu hal berikut terjadi:

reasonYang Anda lewati SendWorkflowStepAction disimpan dengan langkah dan tersedia untuk langkah-langkah selanjutnya sebagai reason output langkah.

Batas Waktu Default: 3 hari

Waktu Batas Maks: 7 hari (604.800 detik)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Diperlukan izin IAM

Peran eksekusi kustom Anda harus memiliki izin berikut untuk menggunakan tindakan langkah ini:

Contoh

Tentukan tindakan langkah dalam dokumen alur kerja dengan notifikasi SNS.

- name: SendEventAndWait
  action: WaitForAction
  onFailure: Abort
  inputs:
    snsTopicArn: arn:aws:sns:us-west-2:111122223333:ExampleTopic

Tentukan tindakan langkah dalam dokumen alur kerja dengan pemanggilan fungsi Lambda.

- name: SendEventAndWaitWithLambda
  action: WaitForAction
  onFailure: Abort
  inputs:
    lambdaFunctionName: ExampleFunction
    payload: |
      {
        "imageId": "{{ $.stepOutputs.CreateImageFromInstance.imageId }}",
        "region": "us-west-2"
      }

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.SendEventAndWait.reason

WaitForSSMAgent

Tindakan langkah ini menunggu instans EC2 dapat dikelola AWS Systems Manager setelah periode tidak responsif yang diharapkan. Ini sangat berharga untuk alur kerja dengan gangguan instans yang diketahui, seperti reboot sistem, peningkatan OS, atau operasi khusus platform yang memutuskan sementara instance dari SSM. Image Builder memantau instance hingga mendapatkan kembali konektivitas SSM atau waktu habis.

Batas Waktu Default: 60 menit

Waktu Batas Maks: 180 menit (3 jam)

Anda dapat mengganti default dengantimeoutSeconds, hingga maksimum yang ditampilkan. Nilai di atas maksimum gagal validasi.

Rollback: Tidak ada rollback untuk tindakan langkah ini.

Input: Tabel berikut mencakup input yang didukung untuk tindakan langkah ini.

Output: Tabel berikut mencakup output untuk tindakan langkah ini.

Contoh

Tentukan langkah tindakan dalam dokumen alur kerja.

- name: WaitForInstanceAfterReboot
  action: WaitForSSMAgent
  onFailure: Abort
  timeoutSeconds: 900
  inputs:
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.WaitForInstanceAfterReboot.status