View a markdown version of this page

Gunakan kemampuan distribusi AMI yang ditingkatkan - EC2 Image Builder
Distribusi yang dipisahkanCoba Lagi DistribusiAlur Kerja Distribusi

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

Gunakan kemampuan distribusi AMI yang ditingkatkan

Image Builder menawarkan kemampuan distribusi lanjutan yang memberi Anda fleksibilitas dan kontrol atas bagaimana AMI Anda didistribusikan di seluruh wilayah dan akun. Kemampuan ini memisahkan distribusi dari proses pembuatan, memungkinkan Anda mendistribusikan gambar yang ada sesuai permintaan, memulihkan dari kegagalan distribusi secara efisien, dan menerapkan strategi distribusi multi-tahap yang terkontrol melalui alur kerja yang dapat disesuaikan.

Anda dapat menggunakan kemampuan distribusi AMI yang disempurnakan di Image Builder untuk melakukan aktivitas distribusi secara langsung tanpa perlu menjalankan ulang build gambar lengkap.

Distribusi yang dipisahkan

DistributeImage API menerima tiga jenis referensi gambar sumber:

  • AMI ID — Pengidentifikasi AMI standar (misalnya,ami-0abcdef1234567890)

  • Parameter SSM — Parameter SSM yang menyimpan ID AMI (misalnya,) ssm:/my/ami/parameter

  • Image Builder versi ARN - Versi gambar Pembuat Gambar ARN

Coba Lagi Distribusi

Jika distribusi gambar gagal, gunakan RetryImage API untuk mencoba lagi distribusi. Ini mengurangi waktu untuk memecahkan masalah penyebab kegagalan dengan menghindari pembuatan ulang gambar lengkap. Gunakan RetryImage setelah menyelesaikan penyebab kegagalan distribusi.

RetryImage API menerima versi build gambar ARN (misalnya,arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1). Saat Anda memanggil API, Image Builder secara otomatis melanjutkan proses distribusi dari titik kegagalan menggunakan konfigurasi dan pengaturan distribusi asli. RetryImageAPI dapat mencoba lagi distribusi yang gagal selama fase distribusi, fase pengujian, atau fase integrasi. Ini bekerja dengan AMI dalam status berikut: tertunda, gagal, dihapus, atau tersedia.

Prasyarat

Sebelum mencoba ulang distribusi, pastikan hal berikut:

  • Anda telah mengidentifikasi dan menyelesaikan akar penyebab kegagalan. Tinjau log distribusi di CloudWatch Log untuk detail kesalahan.

  • Anda memiliki izin IAM yang diperlukan untuk mencoba lagi pembuatan gambar.

  • Untuk kegagalan distribusi lintas akun, verifikasi bahwa Ec2ImageBuilderCrossAccountDistributionAccess kebijakan terlampir EC2ImageBuilderDistributionCrossAccountRole di akun tujuan.

Penting: Men coba lagi tanpa memperbaiki masalah yang mendasarinya akan mengakibatkan kegagalan berulang.

Alur Kerja Distribusi

Alur kerja distribusi adalah jenis alur kerja baru yang melengkapi alur kerja build dan test, memungkinkan Anda untuk menentukan dan mengontrol proses distribusi dengan langkah-langkah berurutan. Dengan alur kerja distribusi, Anda dapat membuat proses distribusi kustom yang mencakup operasi penyalinan AMI, pos pemeriksaan tunggu tindakan, modifikasi atribut gambar, dan langkah-langkah terkait distribusi lainnya. Ini memberikan kontrol terstruktur atas bagaimana AMI Anda didistribusikan, dengan visibilitas tingkat langkah, kemampuan distribusi paralel, dan pelaporan kesalahan terperinci.

Untuk mempelajari selengkapnya tentang membuat dan menyesuaikan alur kerja, lihat Mengel ola Alur Kerja Gambar.