Buat versi baru resep wadah

Untuk membuat versi resep wadah baru:

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

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 API Image Builder. Untuk meninjau parameter permintaan operasi API, lihat CreateContainerRecipe perintah di Refer ensi 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 bersifat opsional untuk resep wadah. Anda dapat menyesuaikan gambar output 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 sesuai urutan yang Anda tentukan dalam resep. Namun, komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa pengujian benchmark berjalan terhadap gambar keluaran Anda.

     • componentArn (string, wajib) — 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. Pembuat Gambar 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 Manajer Rahasia, lihat Apa itu Manajer Rahasia? dalam Panduan AWS Secrets Manager Pengguna. Untuk informasi selengkapnya tentang AWS Systems Manager Penyimpanan Parameter, lihat Penyimpanan AWS Systems Manager Parameter di Panduan AWS Systems Manager Pengguna.

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

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

   • ContainerType (string, required) — Jenis wadah yang akan dibuat. 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 termasuk komponen, sertakan juga environments variabel dan components variabel.

     ParentImage (wajib)

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

     Contoh:

     FROM
     {{{ imagebuilder:parentImage }}}

     lingkungan (diperlukan jika komponen ditentukan)

     Pada waktu pembuatan, variabel ini diselesaikan ke arahan Dockerfile yang menempatkan 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 diselesaikan ke perintah yang menjalankan skrip komponen build dan test untuk komponen yang disertakan resep kontainer, dan kemudian menghapus skrip tersebut dari gambar. 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).

   • name (string, required) — Nama resep wadah.

   • description (string) — Deskripsi resep wadah.

   • ParentImage (string, required) — Gambar Docker wadah yang akan digunakan dalam resep wadah sebagai garis dasar untuk gambar yang disesuaikan.

     • Gambar publik dihosting di DockerHub

     • Gambar kontainer yang ada di Amazon ECR

     • Amazon-managed gambar kontainer

   • platformOverride (string) — Menentukan platform sistem operasi saat Anda menggunakan image 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 kontainer, yang mungkin tidak selalu tersedia. Anda tidak dapat menentukan platformOverride kapan gambar induk Anda adalah gambar Pembuat Gambar ARN. Nilai yang valid adalah Linux dan Windows. Resep kontainer tidak mendukung platform macOS.

   • <major>SemanticVersion (string, wajib) — Versi semantik dari resep wadah ditentukan dalam format berikut, dengan nilai numerik di setiap posisi untuk menunjukkan versi tertentu:. <minor>. <patch>. Sebuah contoh akan 1.0.0. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.

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

   • instanceConfiguration (object) — Sekelompok opsi yang dapat digunakan untuk mengkonfigurasi instance untuk membangun dan menguji gambar kontainer.

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

     • blok DeviceMappings (array objek) - Mendefinisikan perangkat blok yang akan dilampirkan untuk membangun instance dari AMI Pembuat Gambar yang ditentukan dalam image parameter.

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

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

         • delete OnTermination (Boolean) — Digunakan untuk mengkonfigurasi hapus pada penghentian perangkat terkait.

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

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

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

   • targetRepository (objek, wajib) — Repositori tujuan untuk image kontainer jika tidak ada repositori lain yang ditentukan dalam konfigurasi distribusi pipeline Anda untuk Wilayah tempat pipeline berjalan (Wilayah 1).

     • RepositoryName (string, required) — Nama repositori wadah tempat gambar kontainer keluaran 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, sementara Linux dan macOS menggunakan garis miring maju (/).

   Contoh output berikut menunjukkan ARN 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"
   }