Buat versi baru resep wadah

Untuk membuat versi resep wadah baru:

1. Di bagian atas halaman detail resep kontainer, pilih Buat versi baru. Anda dibawa ke 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 tindakan Image Builder API. Untuk meninjau parameter permintaan perintah 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, diperlukan) - Berisi array ComponentConfiguration objek. Setidaknya satu komponen build harus ditentukan:

     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 termasukWilayah AWS, nama, dan nomor versi untuk masing-masing.

     • parameter (array objek) — Berisi array ComponentParameter objek.

       penting

       Parameter komponen adalah nilai teks biasa, dan masukAWS 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 ManagerUser Guide. Untuk informasi selengkapnya tentang AWS Systems Manager Parameter Store, lihat AWS Systems ManagerParameter 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.

   • dockerfileTemplateData(string) - Template Dockerfile yang digunakan untuk membangun gambar Anda, dinyatakan sebagai gumpalan data sebaris.

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

   • deskripsi (string) — Deskripsi resep wadah.

   • ParentImage (string, required) - Gambar yang digunakan resep kontainer sebagai dasar untuk gambar khusus Anda. Nilainya bisa berupa gambar dasar ARN atau ID AMI.

   • PlatforMoverride (string) - Menentukan platform sistem operasi ketika Anda menggunakan gambar dasar kustom.

   • 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. Versi semantik

   • 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) — ID AMI untuk digunakan sebagai image dasar untuk container build dan test instance. Jika Anda tidak menentukan nilai ini, Image Builder menggunakan AMI yang dioptimalkan Amazon ECS yang sesuai sebagai gambar dasar.

     • blockDeviceMappings(array objek) — 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.

         • deleteOnTermination(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 di mana gambar ini terdaftar.

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

   {
      "components": [ 
         { 
            "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012: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-1234567890",
         "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. Sebagai contoh, Windows menggunakan garis miring terbalik (\) sedangkan Linux menggunakan garis miring (/) untuk merujuk ke jalur direktori.