Buat versi baru dari resep gambar

Untuk membuat versi resep gambar baru:

1. Di bagian atas halaman detail resep, pilih Buat versi baru. Ini membawa Anda ke halaman resep Buat gambar.

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

1. Buat file JSON input CLI

   Anda dapat memberikan semua input untuk create-image-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.

   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 CreateImageRecipeperintah 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 yang ditentukan oleh contoh-contoh ini:

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

   • deskripsi (string) — Deskripsi resep gambar.

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

     catatan

     Contoh Linux menggunakan Image Builder AMI, dan contoh Windows menggunakan ARN.

   • SemanticVersion <major>(string, required) — Versi semantik dari resep gambar, dinyatakan dalam format berikut, dengan nilai numerik di setiap posisi untuk menunjukkan versi tertentu:. <minor>. <patch>. Misalnya nilai mungkin1.0.0. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. Versi semantik

   • komponen (array, 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 salah satu contoh untuk membuat resep gambar Anda sendiri, Anda harus mengganti contoh ARN dengan ARN untuk komponen yang Anda gunakan untuk resep Anda.

     • 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 Store 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.

   • additionalInstanceConfiguration(object) — Tentukan setelan tambahan dan luncurkan skrip untuk instance build Anda.

     • systemsManagerAgent(object) — Berisi pengaturan untuk agen Systems Manager pada instance build Anda.

       • uninstallAfterBuild(Boolean) — Mengontrol apakah agen Systems Manager dihapus dari image build akhir Anda sebelum membuat AMI baru. Jika opsi ini diatur ketrue, maka agen dihapus dari gambar akhir. Jika opsi diatur kefalse, maka agen dibiarkan sehingga disertakan dalam AMI baru. Nilai default-nya adalah false.

         catatan

         Jika uninstallAfterBuild atribut tidak disertakan dalam file JSON, dan kondisi berikut benar, maka Image Builder menghapus agen Systems Manager dari gambar akhir sehingga tidak tersedia di AMI:

         • userDataOverrideKosong atau telah dihilangkan dari file JSON.

         • Image Builder secara otomatis menginstal agen Systems Manager pada instance build untuk sistem operasi yang tidak memiliki agen pra-instal pada image dasar.

     • userDataOverride(string) — Berikan perintah atau skrip perintah untuk dijalankan saat Anda meluncurkan instance build.

       catatan

       Data pengguna selalu dikodekan dengan basis 64. Misalnya, perintah berikut dikodekan sebagai: IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       Contoh Linux menggunakan nilai yang dikodekan ini.

   Linux

   Gambar dasar (parentImageproperti) dalam contoh berikut adalah AMI. Saat Anda menggunakan AMI, Anda harus memiliki akses ke AMI, dan AMI harus berada di Wilayah sumber (Wilayah yang sama tempat Image Builder menjalankan perintah). Simpan file sebagaicreate-image-recipe.json, dan gunakan dalam create-image-recipe perintah.

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   Contoh berikut mengacu pada versi terbaru dari gambar Windows Server 2016 English Full Base. ARN dalam contoh ini mereferensikan gambar terbaru di SKU berdasarkan filter versi semantik yang telah Anda tentukan:. arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   catatan

   Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. Versi semantik

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-image-recipe --cli-input-json file://create-image-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.

1. Di bagian Pilih gambar untuk gambar dasar, pilih opsi Impor gambar dasar.

2. Pilih Image Operating System (OS) dan versi OS seperti biasanya.

1. Sumber — Ini bisa berupa bucket S3 atau snapshot EBS.

2. Pilih lokasi disk S3 — Masukkan lokasi di Amazon S3 tempat gambar disk Anda disimpan. Untuk menelusuri lokasi, pilih Browse S3.

3. Untuk menambahkan wadah disk, pilih Tambahkan wadah disk.

Umum

1. Tentukan Nama unik untuk gambar dasar. Jika Anda tidak memasukkan nilai, gambar dasar mewarisi nama resep.

2. Tentukan Versi untuk gambar dasar. Gunakan format berikut: <major>.<minor>.<patch>. Jika Anda tidak memasukkan nilai, gambar dasar mewarisi versi resep.

3. Anda juga dapat memasukkan Deskripsi untuk gambar dasar.