Membuat dan memperbarui konfigurasi distribusi AMI

Buka konsol EC2 Image Builder di https://console.aws.amazon.com/imagebuilder/.

Pilih Setelan distribusi dari panel navigasi. Ini menunjukkan daftar konfigurasi distribusi yang dibuat di bawah akun Anda.

Pilih Buat pengaturan distribusi di dekat bagian atas panel pengaturan distribusi.

Di bagian Jenis gambar, pilih jenis keluaran Amazon Machine Image (AMI).

Di bagian Umum, masukkan Nama untuk konfigurasi distribusi Anda, dan deskripsi opsional.

Di bagian Pengaturan wilayah, masukkan detail berikut untuk setiap Wilayah tempat Anda mendistribusikan AMI Anda:

1. AMI didistribusikan ke Wilayah saat ini (Wil ayah 1), secara default. Wilayah 1 adalah sumber distribusi. Beberapa pengaturan untuk Wilayah 1 tidak terbuka untuk diedit. Untuk setiap Wilayah yang Anda tambahkan, Anda dapat memilih Wilayah dari daftar dropdown Wil ayah.

   Kunci Kms mengidentifikasi AWS KMS key yang digunakan untuk mengenkripsi volume EBS untuk gambar Anda di Wilayah target. Penting untuk dicatat bahwa ini tidak berlaku untuk AMI asli yang dibuat build di bawah akun Anda di Wilayah sumber (Wil ayah 1). Enkripsi yang berjalan selama fase distribusi build hanya untuk gambar yang didistribusikan ke akun atau Wilayah lain.

   Untuk mengenkripsi volume EBS untuk AMI yang dibuat di Wilayah sumber untuk akun Anda, Anda harus mengatur kunci KMS di pemetaan perangkat blok resep gambar (Peny impanan (volume) di konsol).

   Image Builder menyalin AMI ke akun Target yang Anda tentukan untuk Wilayah.

   Prasyarat

   Untuk menyalin gambar di seluruh akun, Anda harus membuat EC2ImageBuilderDistributionCrossAccountRole peran di semua akun target distribusi, dan melampirkan kebijakan ter Ec2ImageBuilderCrossAccountDistributionAccess kebijakan kelola ke peran tersebut.

   Nama AMI keluaran adalah opsional. Jika Anda memberikan nama, nama AMI keluaran akhir menyertakan stempel waktu yang ditambahkan saat AMI dibuat. Jika Anda tidak menentukan nama, Pembuat Gambar menambahkan stempel waktu build ke nama resep. Ini memastikan nama AMI yang unik untuk setiap build.

   1. Dengan berbagi AMI, Anda dapat memberikan akses bagi AWS Principal tertentu untuk meluncurkan instans dari AMI Anda. Jika Anda memperluas bagian berbagi AMI, Anda dapat memasukkan detail berikut:

      • Izin peluncuran — Pilih Pri badi jika Anda ingin menjaga AMI tetap pribadi, dan izinkan akses bagi AWS Principal tertentu untuk meluncurkan instance dari AMI pribadi Anda. Pilih Publik jika Anda ingin menjadikan AMI Anda publik. Setiap AWS Kepala Sekolah dapat meluncurkan instance dari AMI publik Anda.

      • Prinsipal — Anda dapat memberikan akses untuk jenis AWS Principal berikut untuk meluncurkan instance:

        • AWS akun — Memberikan akses ke AWS akun tertentu

        • Unit organisasi (OU) — Memberikan akses ke OU, dan semua entitas turunannya. Entitas anak termasuk OU dan AWS akun.

        • Organisasi — Berikan akses ke entitas Anda AWS Organizations, dan semua entitas turunannya. Entitas anak termasuk OU dan AWS akun.

          Pertama, pilih tipe Principal. Kemudian masukkan ID untuk AWS Kepala Sekolah yang ingin Anda berikan akses di kotak di sebelah kanan daftar drop-down. Anda dapat memasukkan beberapa ID dari berbagai jenis.

   2. Anda dapat memperluas bagian Konfigurasi lisensi untuk melampirkan konfigurasi lisensi yang dibuat AWS License Manager dengan gambar Pembuat Gambar Anda. Konfigurasi lisensi berisi aturan lisensi berdasarkan ketentuan perjanjian perusahaan Anda. Image Builder secara otomatis menyertakan konfigurasi lisensi yang dikaitkan dengan AMI dasar Anda.

   3. Anda dapat memperluas bagian konfigurasi template Launch untuk menentukan template peluncuran EC2 yang akan digunakan untuk meluncurkan instans dari AMI yang Anda buat.

      Jika Anda menggunakan template peluncuran EC2, Anda dapat menginstruksikan Image Builder untuk membuat versi baru template peluncuran Anda yang menyertakan ID AMI terbaru setelah build selesai. Untuk memperbarui template peluncuran, konfigurasikan pengaturan sebagai berikut:

      • Luncurkan nama template — Pilih nama template peluncuran yang ingin Anda perbarui Image Builder.

      • Mengatur versi default — Pilih kotak centang ini untuk memperbarui versi default template peluncuran ke versi baru.

      Untuk menambahkan konfigurasi template peluncuran lainnya, pilih Tambahkan konfigurasi template peluncuran. Anda dapat memiliki hingga lima konfigurasi template peluncuran per Wilayah.

   4. Anda dapat memperluas bagian konfigurasi parameter SSM untuk mengonfigurasi parameter SSM yang akan menyimpan ID AMI keluaran untuk gambar yang didistribusikan ke Wilayah tujuan. Anda dapat secara opsional menentukan akun distribusi di Wilayah.

      Nama parameter — Masukkan nama untuk parameter Anda. Sebagai contoh, /output/image/param.

      Tipe data — Pertahankan nilai default (AWS EC2 Image). Ini memberitahu Manajer Sistem untuk memvalidasi nilai parameter untuk memastikan bahwa itu adalah ID AMI yang valid.

2. Untuk menambahkan setelan distribusi untuk Wilayah lain, pilih Tam bah Wilayah.

Pilih Buat pengaturan setelah Anda selesai.

Buat file JSON input CLI

Gunakan alat pengeditan file untuk membuat file JSON dengan kunci yang ditampilkan dalam salah satu contoh berikut, dan nilai yang valid untuk lingkungan Anda. Contoh-contoh ini menentukan AWS Organizations unit organisasi (OU) mana Akun AWS yang memiliki izin untuk meluncurkan AMI yang Anda distribusikan ke Wilayah yang ditentukan. Beri nama filecreate-ami-distribution-configuration.json, untuk digunakan pada langkah berikutnya:

Contoh 1: Mendistribusikan ke Akun AWS

Contoh ini mendistribusikan AMI ke dua Wilayah, dan menentukan Akun AWS yang memiliki izin peluncuran di setiap Wilayah.

{
	"name": "MyExampleAccountDistribution",
	"description": "Copies AMI to eu-west-1, and specifies accounts that can launch instances in each Region.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"amiTags": {
					"KeyName": "Some Value"
				},
				"launchPermission": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-1",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"amiTags": {
					"KeyName": "Some value"
				},
				"launchPermission": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

Contoh 2: Mendistribusikan ke Organisasi dan OU

Contoh ini mendistribusikan AMI ke Wilayah sumber, dan menentukan organisasi dan izin peluncuran OU.

{
	"name": "MyExampleAWSOrganizationDistribution",
	"description": "Shares AMI with the Organization and OU",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}",
				"launchPermission": {
					"organizationArns": [
						"arn:aws:organizations::123456789012:organization/o-myorganization123"
					],
					"organizationalUnitArns": [
						"arn:aws:organizations::123456789012:ou/o-123example/ou-1234-myorganizationalunit"
					]
				}
			}
		}
	]
}

Contoh 3: Simpan ID AMI keluaran dalam parameter SSM

Contoh ini menyimpan ID AMI keluaran dalam AWS Systems Manager parameter Penyimpanan Parameter di Wilayah distribusi.

{
	"name": "SSMParameterOutputAMI",
	"description": "Updates an SSM parameter with the output AMI ID for the distribution.",
	"distributions": [
		{
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{ imagebuilder:buildDate }}"
			},
			"ssmParameterConfigurations": [
				{
					"amiAccountId": "111122223333",
					"parameterName": "/output/image/param",
					"dataType": "aws:ec2:image"
				}
			]
		}
	]
}

Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.

aws imagebuilder create-distribution-configuration --cli-input-json file://create-ami-distribution-configuration.json

Untuk informasi lebih rinci, lihat create-distribution-configuration di Referensi AWS CLI Perintah.

Buka konsol EC2 Image Builder di https://console.aws.amazon.com/imagebuilder/.

Pilih Setelan distribusi dari panel navigasi. Ini menunjukkan daftar konfigurasi distribusi yang dibuat di bawah akun Anda.

Untuk melihat detail atau memperbarui konfigurasi distribusi, pilih tautan Nama konfigurasi. Ini membuka tampilan detail untuk pengaturan distribusi.

Untuk mengedit konfigurasi distribusi, pilih Edit dari sudut kanan atas bagian Detail distribusi. Beberapa bidang terkunci, seperti Nama konfigurasi distribusi, dan Wil ayah default yang ditampilkan sebagai Wil ayah 1. Untuk informasi selengkapnya tentang pengaturan konfigurasi distribusi, lihatMembuat konfigurasi distribusi AMI.

Setelah selesai, pilih Simpan perubahan.

Buat file JSON input CLI

Gunakan alat pengeditan file untuk membuat file JSON dengan kunci yang ditunjukkan dalam contoh berikut, dan nilai yang valid untuk lingkungan Anda. Contoh ini menggunakan file bernamaupdate-ami-distribution-configuration.json.

{
	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-ami-distribution-configuration.json",
	"description": "Copies AMI to eu-west-2, and specifies accounts that can launch instances in each Region.",
	"distributions": [
	  {
			"region": "us-west-2",
			"amiDistributionConfiguration": {
				"name": "Name {{imagebuilder:buildDate}}",
				"description": "An example image name with parameter references",
				"launchPermissions": {
					"userIds": [
						"987654321012"
					]
				}
			}
		},
		{
			"region": "eu-west-2",
			"amiDistributionConfiguration": {
				"name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
				"tags": {
					"KeyName": "Some value"
				},
				"launchPermissions": {
					"userIds": [
						"100000000001"
					]
				}
			}
		}
	]
}

Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.

aws imagebuilder update-distribution-configuration --cli-input-json file://update-ami-distribution-configuration.json

Untuk informasi lebih rinci, lihat update-distribution-configuration di Referensi AWS CLI Perintah. Untuk memperbarui tag untuk sumber daya konfigurasi distribusi Anda, lihat Memberi tanda pada sumber daya bagian ini.