Buat versi baru resep gambar

Untuk membuat versi resep gambar baru:

1. Di bagian atas halaman detail resep, pilih Buat versi baru. Ini membuka halaman Resep Buat gambar.

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

   Gambar akhir Anda dapat berisi hingga sembilan kode produk dari produk AWS Marketplace gambar dan komponen. Image Builder mengembalikan kesalahan selama pembuatan resep jika gambar dasar dan komponen Anda melebihi batas ini.

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 operasi API Image Builder. Untuk meninjau parameter permintaan operasi API, lihat CreateImageRecipe 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 yang ditentukan contoh-contoh ini:

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

   • description (string) — Deskripsi resep gambar.

   • ParentImage (string, required) — Gambar yang digunakan resep gambar sebagai dasar untuk gambar yang disesuaikan. Anda dapat menentukan gambar induk menggunakan salah satu opsi berikut:

     • AMI ID — Gunakan ketika Anda memiliki AMI tertentu (misalnya,ami-1234567890abcdef1) yang ingin Anda sesuaikan. Karena ID AMI bersifat statis, kami merekomendasikan gambar Image Builder ARN atau parameter SSM sebagai gantinya ketika Anda ingin resep Anda mengambil gambar dasar yang lebih baru secara otomatis.

     • Sumber daya gambar Pembuat Gambar ARN - Gunakan saat Anda ingin membangun di atas gambar Pembuat Gambar. Ini termasuk Amazon-managed gambar yang disediakan Image Builder untuk sistem operasi paling populer, serta gambar yang Anda buat sebelumnya. Tentukan gambar ARN dengan versi semantik, atau gunakan wildcard versi untuk selalu mendapatkan versi terbaru.

     • AWS Systems Manager Parameter Penyimpanan Parameter (SSM) — Gunakan saat Anda ingin resep Anda secara otomatis mengambil ID AMI baru tanpa membuat versi resep baru. Mengawali parameter denganssm:, diikuti dengan nama parameter atau ARN. Ini sangat ideal untuk pipeline yang harus selalu menggunakan gambar dasar Amazon Linux atau Windows terbaru.

     • AWS Marketplace ID produk — Gunakan saat Anda berlangganan produk AMI AWS Marketplace dan ingin menyesuaikannya lebih lanjut.

     catatan

     • Saat Anda menggunakan ID AMI atau parameter SSM yang diselesaikan ke AMI, Anda harus memiliki akses ke AMI tersebut di akun Anda. AMI juga harus ada di Wilayah yang sama tempat Image Builder menjalankan build.

     • Contoh Linux dan macOS menentukan ID AMI, dan contoh Windows menggunakan gambar Image Builder ARN.

   • <major>SemanticVersion (string, required) — Masukkan nomor versi yang ingin Anda buat dalam format. <minor>. <patch>. Image Builder mendukung penambahan versi otomatis untuk resep, memungkinkan Anda menggunakan pola wildcard dalam versi resep Anda. Saat Anda membuat resep dengan versi wildcard seperti1.0.x, Image Builder secara otomatis menambah versi (misalnya,,, 1.0.1 1.0.21.0.3, dan seterusnya). Ini menghilangkan kebutuhan untuk melacak dan menambah versi resep secara manual. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.

   • komponen (array, opsional) - Berisi array ComponentConfiguration objek. Komponen bersifat opsional - Anda dapat membuat resep tanpa komponen apa pun untuk pengujian atau alur kerja distribusi:

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

   • AmiWatermarks (array string, opsional) - Daftar nama tanda air untuk dilampirkan ke AMI keluaran yang dibuat dari resep ini. Tanda air adalah penanda garis keturunan yang membantu Anda melacak sejarah gambar Anda. Tentukan 1 hingga 5 nama. Setiap nama harus terdiri dari 3 hingga 128 karakter, dan dapat mencakup huruf, angka, spasi, dan karakter khusus berikut: ( ) [ ] . / - ' @ _ Untuk informasi selengkapnya, lihat Lacak garis keturunan AMI dengan tanda air.

   • tambahan InstanceConfiguration (objek) — Tentukan pengaturan tambahan dan luncurkan skrip untuk instance build Anda.

     • systems ManagerAgent (object) — Berisi pengaturan untuk agen System Manager pada instance build Anda.

       catatan

       Resep Windows tidak mendukung systemsManagerAgent konfigurasi. Jika Anda menyertakannya dengan gambar induk Windows, permintaan gagal.

       • uninstall AfterBuild (Boolean) — Mengontrol apakah agen Manajer Sistem dihapus dari image build akhir Anda sebelum membuat AMI baru. Jika opsi ini diset true el ke, maka agen dihapus dari gambar akhir. Jika opsi disetel 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 Manajer Sistem dari gambar akhir sehingga tidak tersedia di AMI:

         • userDataOverrideItu kosong atau telah dihilangkan dari file JSON.

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

     • user DataOverride (string) — Menyediakan perintah atau skrip perintah untuk dijalankan saat Anda meluncurkan instance build Anda.

       catatan

       Data pengguna selalu dikodekan berdasarkan 64. Misalnya, perintah berikut dikodekan sebagaiIyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==:

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

       Contoh Linux menggunakan nilai yang dikodekan ini.

   Linux

   Gambar dasar (parentImageproperti) dalam contoh berikut adalah AMI. Ketika 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-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333: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 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:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   catatan

   Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.

   macOS

   Gambar dasar (parentImageproperti) dalam contoh berikut adalah AMI. Ketika 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": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Contoh: Resep tanpa komponen

   Anda dapat membuat resep tanpa komponen apa pun untuk menguji AMI yang ada atau alur kerja khusus distribusi. Contoh berikut menunjukkan resep yang menggunakan AMI yang ada tanpa menerapkan komponen tambahan apa pun:

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

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. Misalnya, Windows menggunakan garis miring terbalik (\) untuk merujuk ke jalur direktori, sementara Linux dan macOS menggunakan garis miring maju (/).

   Gambar akhir Anda dapat berisi hingga sembilan kode produk dari produk AWS Marketplace gambar dan komponen. Pembuat Gambar mengembalikan kesalahan selama pembuatan resep jika gambar dasar dan komponen Anda melebihi batas ini saat Anda menjalankan create-image-recipe perintah.

   Perintah mengembalikan ARN resep gambar baru, seperti yang ditunjukkan dalam contoh output berikut.

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

3. Verifikasi resep Anda

   Untuk mengonfirmasi bahwa Image Builder membuat resep Anda seperti yang diharapkan, jalankan get-image-recipe perintah dengan ARN yang dikembalikan langkah sebelumnya.

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

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 Jelajahi 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.