Buat versi baru resep wadah

Untuk membuat versi resep kontainer baru:

1. Pada halaman detail resep kontainer, pilih Buat versi baru di bagian atas halaman. Konsol membuka halaman Buat resep untuk resep wadah.

2. Untuk membuat versi baru, buat perubahan, lalu pilih Buat resep.

1. Buat file JSON input CLI

   Anda dapat memberikan semua input untuk create-container-recipe perintah dengan parameter perintah inline. Namun, perintah yang dihasilkan bisa sangat panjang. Untuk merampingkan perintah, Anda dapat menyediakan file JSON yang berisi semua pengaturan resep wadah

   catatan

   Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan operasi Image Builder API. Untuk meninjau parameter permintaan operasi API, lihat CreateContainerRecipeperintah di Referensi API EC2 Image Builder.

   Untuk memberikan nilai data sebagai parameter baris perintah, lihat nama parameter yang ditentukan dalam Referensi AWS CLI Perintah.

   Berikut adalah ringkasan parameter dalam contoh ini:

   • komponen (array objek, opsional) - Berisi array ComponentConfiguration objek. Komponen adalah opsional untuk resep wadah. Anda dapat menyesuaikan gambar keluaran dengan komponen BUILD, dengan instruksi di template Dockerfile Anda (misalnya, RUN atau COPY pernyataan), atau keduanya. Komponen TEST memvalidasi gambar tetapi tidak memodifikasinya.

     catatan

     Image Builder menginstal komponen dalam urutan yang Anda tentukan dalam resep. Namun, komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa tes benchmark berjalan terhadap gambar keluaran Anda.

     • ComponentARN (string, diperlukan) — Komponen ARN.

       Tip

       Untuk menggunakan contoh untuk membuat resep wadah Anda sendiri, ganti contoh ARN dengan ARN untuk komponen yang Anda gunakan untuk resep Anda,. Ini termasuk Wilayah AWS, nama, dan nomor versi untuk masing-masing.

     • parameter (array objek) — Berisi array ComponentParameter objek. Jika parameter input diperlukan, tetapi tidak memiliki nilai default yang ditentukan dalam komponen, Anda harus memberikan nilai. Image Builder tidak akan membuat versi resep jika ada parameter yang diperlukan yang hilang dan tidak memiliki nilai default yang ditentukan.

       penting

       Parameter komponen adalah nilai teks biasa, dan masuk AWS CloudTrail. Kami menyarankan Anda menggunakan AWS Secrets Manager atau AWS Systems Manager Parameter Store untuk menyimpan rahasia Anda. Untuk informasi selengkapnya tentang Secrets Manager, lihat Apa itu Secrets Manager? dalam AWS Secrets Manager User Guide. Untuk informasi selengkapnya tentang AWS Systems Manager Parameter Store, lihat AWS Systems Manager Parameter Menyimpan di Panduan AWS Systems Manager Pengguna.

       • name (string, required) — Nama parameter komponen yang akan ditetapkan.

       • value (array string, required) — Berisi array string untuk mengatur nilai untuk parameter komponen bernama. Jika ada nilai default yang ditentukan untuk komponen, dan tidak ada nilai lain yang disediakan, AWSTOE gunakan nilai default.

   • ContainerType (string, required) - Jenis wadah untuk membuat. Nilai yang valid termasukDOCKER.

   • dockerfile TemplateData (string) - Template Dockerfile inline untuk membangun gambar Anda. Data inline dibatasi hingga 16.000 karakter. Anda dapat menentukan dockerfileTemplateData atau dockerfileTemplateUri, tetapi bukan keduanya.

     Template Dockerfile Anda dapat menyertakan variabel kontekstual (placeholder yang diganti Image Builder dengan informasi build saat runtime). Sertakan setidaknya parentImage variabel. Jika resep Anda menyertakan komponen, sertakan juga environments variabel dan components variabelnya.

     ParentImage (wajib)

     Pada waktu pembuatan, variabel ini menyelesaikan gambar dasar untuk resep Anda.

     Contoh:

     FROM
     {{{ imagebuilder:parentImage }}}

     lingkungan (diperlukan jika komponen ditentukan)

     Pada waktu pembuatan, variabel ini menyelesaikan arahan Dockerfile yang mementaskan komponen Anda dalam konteks build. Arahan ini menyalin skrip komponen ke dalam gambar dan mengatur variabel lingkungan yang digunakan skrip tersebut. Ini mempersiapkan lingkungan tetapi tidak menjalankan komponen yang Anda tentukan. Tempatkan variabel ini sebelum components variabel.

     Contoh:

     {{{ imagebuilder:environments }}}

     komponen (opsional)

     Pada waktu pembuatan, variabel ini menyelesaikan perintah yang menjalankan skrip komponen build dan test untuk komponen yang disertakan dalam resep container, lalu menghapus skrip tersebut dari image. Ini adalah variabel yang menjalankan komponen Anda. Tempatkan setelah environments variabel.

     Contoh:

     {{{ imagebuilder:components }}}

     Untuk menyimpan template di Amazon S3 sebagai gantinya, gunakan TemplateUri parameter dockerfile dengan URI Amazon S3 yang valid (misalnya,). s3://my-bucket/templates/Dockerfile

   • nama (string, wajib) — Nama resep wadah.

   • deskripsi (string) — Deskripsi resep wadah.

   • ParentImage (string, required) - Gambar Docker kontainer yang akan digunakan dalam resep wadah sebagai dasar untuk gambar khusus Anda.

     • Gambar publik dihosting di DockerHub

     • Gambar kontainer yang ada di Amazon ECR

     • Amazon-managed gambar kontainer

   • PlatforMoverride (string) - Menentukan platform sistem operasi ketika Anda menggunakan gambar dasar kustom. Kami menyarankan Anda menetapkan nilai ini saat Anda menggunakan gambar ECR Docker Hub atau Amazon. Jika Anda menghilangkannya, Image Builder mencoba mendeteksi platform dari manifes container, yang mungkin tidak selalu tersedia. Anda tidak dapat menentukan platformOverride kapan gambar induk Anda adalah ARN image Builder Image Builder. Nilai yang valid adalah Linux dan Windows. Resep kontainer tidak mendukung platform macOS.

   • SemanticVersion <major>(string, required) - Versi semantik dari resep kontainer yang ditentukan dalam format berikut, dengan nilai numerik di setiap posisi untuk menunjukkan versi tertentu:. <minor>. <patch>. Sebuah contoh akan 1.0.0. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. Pembuatan versi semantik di Image Builder

   • tag (peta string) — Tag yang dilampirkan pada resep wadah.

   • InstanceConfiguration (object) - Sekelompok opsi yang dapat digunakan untuk mengonfigurasi instance untuk membangun dan menguji gambar kontainer.

     • image (string) - Gambar dasar untuk container build dan test instance. Ini dapat berisi ID AMI atau dapat menentukan parameter Parameter Store AWS Systems Manager (SSM), diawali olehssm:, diikuti oleh nama parameter atau ARN. Jika Anda menggunakan parameter SSM, nilai parameter harus berisi ID AMI. Jika Anda tidak menentukan gambar dasar, Image Builder menggunakan AMI yang dioptimalkan Amazon ECS yang sesuai sebagai gambar dasar.

     • block DeviceMappings (array of objects) — Mendefinisikan perangkat blok yang akan dilampirkan untuk membangun instance dari Image Builder AMI yang ditentukan dalam image parameter.

       • DeviceName (string) - Perangkat yang diterapkan pemetaan ini.

       • ebs (object) - Digunakan untuk mengelola konfigurasi khusus Amazon EBS untuk pemetaan ini.

         • delete OnTermination (Boolean) - Digunakan untuk mengkonfigurasi penghapusan pada penghentian perangkat terkait.

         • dienkripsi (Boolean) - Digunakan untuk mengkonfigurasi enkripsi perangkat.

         • VolumeSize (integer) - Digunakan untuk mengganti ukuran volume perangkat.

         • VolumeType (string) - Digunakan untuk mengganti jenis volume perangkat.

   • TargetRepository (object, required) - Repositori tujuan untuk image container jika tidak ada repositori lain yang ditentukan dalam konfigurasi distribusi pipeline Anda untuk Wilayah tempat pipeline berjalan (Wilayah 1).

     • RepositoryName (string, required) - Nama repositori kontainer tempat gambar kontainer output disimpan. Nama ini diawali dengan lokasi repositori.

     • service (string, required) - Menentukan layanan repositori yang menyimpan gambar output. Nilai yang valid adalahECR. Repositori target harus sudah ada.

   • WorkingDirectory (string) - Direktori kerja untuk digunakan selama alur kerja build dan pengujian.

   Contoh berikut menunjukkan file input resep kontainer lengkap yang mendefinisikan Docker wadah Linux dengan komponen build. Simpan sebagaicreate-container-recipe.json, dan gunakan dalam create-container-recipe perintah.

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890abcdef1",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. Buat resepnya

   Gunakan perintah berikut untuk membuat resep. Berikan nama file JSON yang Anda buat pada langkah sebelumnya dalam --cli-input-json parameter:

   aws imagebuilder create-container-recipe --cli-input-json file://create-container-recipe.json

   catatan

   • Anda harus menyertakan notasi file:// pada awal jalur file JSON.

   • Jalur untuk file JSON harus mengikuti konvensi yang sesuai untuk sistem operasi dasar tempat Anda menjalankan perintah. Misalnya, Windows menggunakan garis miring terbalik (\) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

   Contoh output berikut menunjukkan ARN dari resep kontainer yang baru dibuat, bersama dengan ID permintaan dan token klien untuk permintaan tersebut.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2"
   }