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 Image Builder.

ApplyImageConfigurations

Tindakan langkah ini menerapkan berbagai konfigurasi dan integrasi untuk didistribusikan AMIs, seperti konfigurasi lisensi, konfigurasi template peluncuran, konfigurasi ekspor S3, konfigurasi EC2 Fast Launch, dan konfigurasi parameter Systems Manager. Konfigurasi berlaku untuk gambar terdistribusi hanya di akun sumber, kecuali untuk konfigurasi parameter SSM yang dapat diterapkan lintas akun.

Batas Waktu Default: 360 menit

Batas Waktu Maks: 720 menit

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 tindakan langkah dalam dokumen alur kerja.

- name: ApplyImageConfigurations
  action: ApplyImageConfigurations
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages

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 Systems Manager untuk menjalankan skrip ini. sendCommand Untuk informasi selengkapnya, lihat AWS Systems Manager Menjalankan Perintah.

Batas Waktu Default: 60 menit

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 tindakan langkah 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 (Systems Manager) pada EC2 instance yang diluncurkan untuk membangun dan menguji gambar Anda. Image Builder mengumpulkan informasi tambahan tentang instance yang digunakan selama fase build dengan Systems Manager Inventory. Informasi ini mencakup nama dan versi sistem operasi (OS), serta daftar paket dan versinya masing-masing seperti yang dilaporkan oleh sistem operasi Anda.

Batas Waktu Default: 30 menit

Rollback: Image Builder mengembalikan semua sumber daya Systems Manager 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 tindakan langkah 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

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 tindakan langkah 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 keadaan yang benar sebelum dilanjutkan.

Batas Waktu Default: 720 menit

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 tindakan langkah 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

DistributeImage

Tindakan langkah ini mendistribusikan AMI ke wilayah dan akun tertentu. Ini membuat salinan AMI di wilayah target dan akun berdasarkan konfigurasi distribusi yang disediakan yang diberikan dalam permintaan untuk CreateImage atau CreateImagePipeline APIs atau pengaturan distribusi khusus yang disediakan dalam alur kerja untuk mengganti pengaturan dalam konfigurasi distribusi.

Batas Waktu Default: 360 menit

Batas Waktu Maks: 720 menit

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 tindakan langkah 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 Systems Manager untuk menjalankan komponen. sendCommand Untuk informasi selengkapnya, lihat AWS Systems Manager Menjalankan Perintah.

Batas Waktu Default: 720 menit

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 tindakan langkah 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 state machine 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 Pelajari tentang mesin status di Step Functions di Panduan AWS Step Functions Pengembang.

Batas Waktu Default: 6 jam

Batas Waktu Maks: 24 jam

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.

Izin IAM diperlukan

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

Contoh

Tentukan tindakan langkah 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

Tindakan langkah ini meluncurkan instance di Anda Akun AWS dan menunggu hingga agen Systems Manager berjalan pada instance sebelum melanjutkan ke langkah berikutnya. Tindakan peluncuran menggunakan pengaturan dari sumber daya konfigurasi resep dan infrastruktur yang terkait dengan gambar Anda. Misalnya, jenis instance yang akan diluncurkan berasal dari konfigurasi infrastruktur. Outputnya adalah ID instance dari instance yang diluncurkan.

waitForInput mengkonfigurasi kondisi yang memenuhi persyaratan penyelesaian langkah.

Batas Waktu Default: 60 menit

Rollback: Untuk instance build, rollback melakukan tindakan yang telah dikonfigurasi 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 tindakan langkah dalam dokumen alur kerja.

- name: LaunchStep
  action: LaunchInstance
  onFailure: Abort
  inputs:
    waitFor: ssmAgent

Gunakan output dari tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.LaunchStep.instanceId

ModifyImageAttributes

Tindakan langkah ini memodifikasi atribut terdistribusi AMIs, seperti izin peluncuran dan atribut AMI lainnya. Ini beroperasi pada AMIs yang telah didistribusikan ke wilayah target dan akun.

Batas Waktu Default: 120 menit

Batas Waktu Maks: 180 menit

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 tindakan langkah dalam dokumen alur kerja.

- name: ModifyImageAttributes
  action: ModifyImageAttributes
  onFailure: Abort
  inputs:
    distributedImages.$: $.stepOutputs.DistributeImageStep.distributedImages

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 atau kumpulan snapshot yang ada, menentukan berbagai atribut gambar.

Batas Waktu Default: 720 menit

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 tindakan langkah 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 Systems Manager untuk menjalankannya untuk Anda. sendCommand Untuk informasi selengkapnya, lihat AWS Systems Manager Menjalankan Perintah.

Batas Waktu Default: 12 jam

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 tindakan langkah 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 Systems Manager untuk menjalankan AWSEC2-RunSysprep dokumen untuk instance Windows sebelum instance build dimatikan untuk snapshot. sendCommand Tindakan ini mengikuti praktik AWS terbaik untuk pengerasan dan pembersihan gambar.

Batas Waktu Default: 60 menit

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 tindakan langkah 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 instance Linux sebelum instance build dimatikan untuk snapshot. Skrip sanitasi membantu memastikan bahwa gambar akhir mengikuti praktik terbaik keamanan, dan artefak atau pengaturan build yang tidak boleh terbawa ke snapshot Anda dihapus. Untuk informasi lebih lanjut tentang skrip, lihatDiperlukan pembersihan pasca-build. Tindakan langkah ini tidak berlaku untuk gambar kontainer.

Image Builder menggunakan API Systems Manager untuk menjalankan skrip ini. sendCommand Untuk informasi selengkapnya, lihat AWS Systems Manager Menjalankan Perintah.

Batas Waktu Default: 60 menit

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 tindakan langkah 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 dengan id instance yang diteruskan sebagai input.

Batas Waktu Default: 30 menit

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 tindakan langkah dalam dokumen alur kerja.

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

WaitForAction

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

Batas Waktu Default: 3 hari

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 tindakan langkah dalam dokumen alur kerja dengan pemberitahuan 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 sebuah EC2 contoh untuk dikelola AWS Systems Manager setelah periode yang tidak responsif yang diharapkan. Ini sangat berharga untuk alur kerja dengan interupsi instance 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

Batas Waktu Maks: 180 menit

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 tindakan langkah dalam dokumen alur kerja.

- name: WaitForInstanceAfterReboot
  action: WaitForSSMAgent
  onFailure: Abort
  timeoutInSeconds: 900 # 15 minutes
  inputs:
    instanceId.$: $.stepOutputs.LaunchStep.instanceId

Gunakan output dari nilai tindakan langkah dalam dokumen alur kerja.

$.stepOutputs.WaitForInstanceAfterReboot.Status