Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Kelola resep di Image Builder
Resep EC2 Image Builder adalah cetak biru untuk membuat gambar mesin yang disesuaikan. Sebuah resep menentukan tiga elemen kunci:
-
Gambar dasar — Titik awal untuk gambar Anda (AMI, image wadah, atau VM yang diimpor).
-
Kompon en — Langkah-langkah pembuatan dan pengujian yang menyesuaikan gambar Anda. Komponen bersifat opsional. Desain ini mendukung alur kerja pengujian dan distribusi saja.
-
Konfigur asi — Volume penyimpanan, pengaturan instance, direktori kerja, dan parameter waktu pembuatan lainnya.
Image Builder mendukung dua jenis resep:
-
Resep gambar menghasilkan Amazon Machine Images (AMI) yang dapat Anda gunakan untuk meluncurkan instans Amazon EC2.
-
Resep kontainer menghasilkan gambar Docker wadah yang disimpan di repositori Amazon ECR.
Resep tidak berubah. Setelah membuat resep, Anda tidak dapat memodifikasi atau menggantinya. Untuk memperbarui komponen atau konfigurasi lainnya, Anda harus membuat resep atau versi resep baru. Image Builder mempertahankan semua versi sebelumnya. Ini memungkinkan Anda melacak garis keturunan gambar kembali ke resep yang tepat yang menghasilkan setiap output. Anda selalu dapat menerapkan tag ke resep yang ada. Untuk informasi selengkapnya tentang menandai sumber daya Anda menggunakan perintah Pembuat Gambar di AWS CLI, lihat Memberi tanda pada sumber daya bagian panduan ini.
Tip
Anda dapat menggunakan komponen yang dikelola Amazon dalam resep Anda, atau Anda dapat mengembangkan komponen khusus Anda sendiri. Untuk informasi selengkapnya, lihat Mengembangkan komponen kustom untuk image Image Builder. Untuk resep gambar yang membuat AMI keluaran, Anda juga dapat menggunakan produk dan komponen AWS Marketplace gambar. Untuk informasi selengkapnya tentang integrasi dengan AWS Marketplace produk, lihatAWS Marketplace integrasi dalam Pembuat Gambar.
Gunakan topik di bagian ini untuk mengelola resep EC2 Image Builder Anda, termasuk mencantumkan resep yang ada, melihat detailnya, dan membuat versi resep baru.
Daftar Isi
Resep gambar dibandingkan dengan resep wadah
Tabel berikut membandingkan fitur resep gambar dan resep wadah.
| Fitur | Resep gambar | Resep wadah |
|---|---|---|
| Output | AMI | Dockergambar wadah di Amazon ECR |
| Sumber gambar dasar | ID AMI, gambar Pembuat Gambar ARN, parameter SSM, produk AWS Marketplace | Docker Hubgambar, gambar Amazon ECR, Amazon-managed gambar, Gambar Pembuat Gambar ARN |
| Dockerfile | Tidak berlaku | Diperlukan (template dengan variabel kontekstual) |
| Repositori target | Tidak berlaku | Amazon ECR (wajib) |
| Konfigurasi penyimpanan | Memblokir pemetaan perangkat untuk AMI keluaran | Memblokir pemetaan perangkat untuk instance build |
| Data pengguna | Didukung (mengesampingkan cloud-init default) | Tidak didukung di tingkat resep |
| Kontrol agen Manajer Sistem | Dapat dikonfigurasi (uninstall setelah build) | Tidak dapat dikonfigurasi |
| AWS Marketplace komponen | Didukung | Tidak Support |
| Penggantian platform | Tidak berlaku (terdeteksi dari AMI) | Tersedia untuk Amazon ECR dan Docker Hub gambar |
Pembuatan versi resep
<major>Setiap resep menggunakan versi semantik dalam format. <minor>. <patch>. Setiap node versi menerima nilai dari 0 hingga 1.073.741.823 (2^30 - 1).
Anda dapat menggunakan wildcard (x) dalam satu posisi untuk mengaktifkan penambahan versi otomatis. Saat Anda membuat resep dengan versi wildcard, Image Builder menggantinya x dengan nomor berikutnya yang tersedia untuk posisi itu.
| Pola | Perilaku | Contoh urutan |
|---|---|---|
1.0.x |
Meningkatkan nomor patch | 1.0.1, 1.0.2, 1.0.3,... |
1.x.0 |
Meningkatkan angka minor | 1.1.0, 1.2.0, 1.3.0,... |
x.0.0 |
Meningkatkan angka utama | 1.0.0, 2.0.0, 3.0.0,... |
Aturan berikut berlaku untuk versi wildcard:
-
Hanya satu
xwildcard yang diperbolehkan per string versi. -
Wildcard dapat muncul di posisi tunggal mana pun (mayor, minor, atau patch).
-
Nilai numerik di posisi yang tersisa harus berupa bilangan bulat eksplisit.
Tip
Gunakan versi wildcard dalam CI/CD otomatisasi Anda sehingga Anda tidak perlu melacak dan menambah versi resep dengan tangan. Setiap kali Anda membuat resep dengan wildcard yang sama, Pembuat Gambar menyelesaikan versi berikutnya yang tersedia. Misalnya, resep yang selalu menggunakan 1.0.x resolves to1.0.1, then1.0.2, dan seterusnya. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.
Kendala dan batasan resep
Sebelum Anda membuat resep, tinjau batasan berikut.
| Kendala | Kuota | Catatan |
|---|---|---|
| Komponen per resep | 20 (default) | Termasuk komponen build dan test. Anda dapat meminta kenaikan melalui AWS Dukungan. |
| Ukuran resep maksimum | 25KB | Ukuran kumulatif dari semua konfigurasi komponen, termasuk nilai parameter. |
| Kode produk per gambar keluaran | 9 | Dikombinasikan dari gambar dasar dan AWS Marketplace komponen. |
| Keunikan komponen | Satu per resep | Komponen yang sama (terlepas dari versi) hanya dapat muncul sekali. |
| Versi node maksimum | 1٬073.741,823 | Per node (mayor, minor, atau patch). |
| Nama resep | Tidak dapat diubah | Nama diperbaiki setelah penciptaan. Buat resep baru untuk nama yang berbeda. |
Komponen juga harus memenuhi persyaratan kompatibilitas berikut:
-
Komponen harus sesuai dengan platform resep (Linux, Windows, atau macOS).
-
Komponen harus mendukung versi OS image induk, ketika metadata versi OS tersedia.
-
Komponen dengan
DISABLEDstatusDEPRECATEDatau tidak dapat ditambahkan ke resep baru. -
Komponen pengerasan CIS memerlukan gambar CIS-published induk.
Pembersihan sumber daya
Untuk menghindari biaya tak terduga, pastikan untuk membersihkan sumber daya dan saluran pipa yang Anda buat dari contoh dalam panduan ini. Untuk informasi selengkapnya tentang menghapus sumber daya di Pembuat Gambar, lihatHapus sumber daya Image Builder yang sudah usang atau tidak digunakan.
