Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Membuat dan memperbarui konfigurasi distribusi AMI Bagian ini mencakup pembuatan dan pembaruan konfigurasi distribusi untuk AMI Pembuat Gambar. **Topics** + [Prasyarat distribusi AMI](#ami-distribution-config-prereqs) + [Membuat konfigurasi distribusi AMI](#create-ami-distribution-config) + [Memperbarui konfigurasi distribusi AMI](#update-ami-distribution-config) + [Contoh: Aktifkan Peluncuran Cepat EC2 dengan template peluncuran untuk AMI keluaran](#create-ami-dist-win-fast-launch) + [Contoh: Buat pengaturan distribusi untuk disk VM keluaran dari AWS CLI](#cli-create-vm-dist-config) ## Prasyarat distribusi AMI Beberapa pengaturan distribusi memiliki prasyarat, sebagai berikut: **Topics** + [Prasyarat parameter keluaran SSM](#ami-distribution-prereqs-ssm-param) + [Prasyarat Peluncuran Cepat EC2](#ami-distribution-prereqs-fast-launch) ### Prasyarat untuk parameter keluaran SSM Sebelum Anda membuat konfigurasi distribusi AMI baru yang menetapkan AWS Systems Manager parameter Penyimpanan Parameter (parameter SSM), pastikan bahwa Anda telah memenuhi prasyarat berikut. **Peran eksekusi ** Saat Anda membuat pipeline atau menggunakan perintah create-image di AWS CLI, Anda hanya dapat menentukan satu peran eksekusi Image Builder. Jika Anda telah menentukan peran eksekusi alur kerja Pembuat Gambar, Anda akan menambahkan izin fitur tambahan apa pun ke peran tersebut. Jika tidak, Anda akan membuat peran kustom baru yang menyertakan izin yang diperlukan. Kami menyarankan agar Anda tidak meneruskan peran [AWSServiceRoleForImageBuilder](security-iam-awsmanpol.md#sec-iam-manpol-AWSServiceRoleForImageBuilder) terkait layanan sebagai peran eksekusi Anda. Sebagai gantinya, buat peran IAM khusus dan lampirkan kebijakan terkel [EC2ImageBuilderExecutionPolicy](security-iam-awsmanpol.md#sec-iam-manpol-EC2ImageBuilderExecutionPolicy) AWS ola. Kebijakan ini memberikan izin yang sama dengan yang diperlukan Pembuat Gambar untuk memang Layanan AWS gil atas nama Anda. Menggunakan peran khusus memberi Anda kontrol penuh atas izin yang digunakan Pembuat Gambar. Ini juga menjaga kebijakan kontrol layanan (SCP) dan kebijakan kontrol sumber daya (RCP) tetap berlaku untuk operasi yang dilakukan Pembuat Gambar atas nama Anda. + Untuk menyimpan ID AMI keluaran dalam parameter SSM selama distribusi, Anda harus menentukan `ssm:PutParameter` tindakan dalam peran eksekusi Image Builder Anda, dengan parameter terdaftar sebagai sumber daya. + Ketika Anda menyetel tipe data parameter `AWS EC2 Image` untuk memberi sinyal Manajer Sistem untuk memvalidasi nilai parameter sebagai ID AMI, Anda juga harus menambahkan `ec2:DescribeImages` tindakan. **Opt-in Wilayah ** Anda harus mengaktifkan Wilayah [ opt-in (Wilayah yang dinonaktifkan secara default) ](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html?icmpid=docs_homepage_addtlrcs#optinregion) di akun sumber. Persyaratan ini berlaku ketika konfigurasi distribusi menargetkan Wilayah `ssmParameterConfigurations` tersebut, baik Anda menggunakan peran terkait layanan Pembuat Gambar atau peran eksekusi khusus. Salinan AMI ke Wilayah opt-in dapat berhasil bahkan ketika akun sumber belum mengaktifkan Wilayah. Hanya penulisan parameter keluaran SSM yang gagal. Tanpa prasyarat ini, build gagal dengan kesalahan yang mirip dengan berikut ini: ``` In region 'af-south-1' - 'STS Client Error: The provided execution role does not exist or does not have sufficient permissions.' ``` Untuk mengatasi masalah ini, lakukan salah satu hal berikut: + Aktifkan Wilayah opt-in di akun sumber. Untuk petunjuk tentang cara mengaktifkan Wilayah, lihat Meng [ aktifkan atau menonaktifkan Wil AWS ayah di akun Anda ](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) di *AWS Panduan Referensi Manajemen Akun*. + Hilangkan `ssmParameterConfigurations` untuk Wilayah opt-in. Sebagai gantinya, gunakan EventBridge aturan Amazon untuk bereaksi terhadap [ acara ](integ-eventbridge.md#eb-event-state-change) EC2 Image Builder Image State Change dan tulis sendiri parameternya. ### Prasyarat untuk Peluncuran Cepat EC2 Sebelum Anda membuat konfigurasi distribusi baru untuk EC2 Fast Launch untuk AMI Windows, pastikan Anda telah memenuhi prasyarat berikut. + Jika Anda menyediakan template peluncuran khusus saat mengonfigurasi Peluncuran Cepat EC2, layanan menggunakan VPC dan pengaturan konfigurasi lainnya yang telah Anda tetapkan dalam template peluncuran. Untuk informasi selengkapnya, lihat [ Menggunakan template peluncuran saat Anda mengatur Peluncuran ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/win-fast-launch-configure.html#win-fast-launch-with-template) Cepat EC2. + Jika Anda tidak menggunakan templat peluncuran khusus untuk mengonfigurasi pengaturan, Anda harus melampirkan [EC2FastLaunchFullAccess](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-iam-awsmanpol-EC2FastLaunchFullAccess.html) kebijakan ke peran IAM yang digunakan Pembuat Gambar untuk membuat gambar Anda. Saat Anda membuat pipeline atau menggunakan perintah create-image di AWS CLI, Anda hanya dapat menentukan satu peran eksekusi Image Builder. Jika Anda telah menentukan peran eksekusi alur kerja Pembuat Gambar, Anda akan menambahkan izin fitur tambahan apa pun ke peran tersebut. Jika tidak, Anda akan membuat peran kustom baru yang menyertakan izin yang diperlukan. Fitur ini memerlukan izin tambahan di luar yang ada di kebijakan eksekusi dasar, jadi Anda harus menggunakan peran khusus. Sebaiknya buat peran kustom dengan kebijakan terkel [EC2ImageBuilderExecutionPolicy](security-iam-awsmanpol.md#sec-iam-manpol-EC2ImageBuilderExecutionPolicy) AWS ola yang dilampirkan, lalu menambahkan EC2FastLaunchFullAccess kebijakan ke peran tersebut. Kemudian, ketika Image Builder menyalin gambar Anda, EC2 Fast Launch secara otomatis membuat CloudFormation tumpukan dengan sumber daya berikut di Anda Akun AWS. + Cloud pribadi virtual (VPC) + Subnet pribadi di beberapa Zona Ketersediaan + Template peluncuran dikonfigurasi dengan Instance Metadata Service Versi 2 (IMDSv2) + Grup keamanan tanpa aturan masuk atau keluar **catatan** Image Builder tidak mendukung distribusi lintas akun untuk AMI dengan EC2 Fast Launch pra-diaktifkan. Peluncuran Cepat EC2 harus diaktifkan dari akun tujuan. ## Membuat konfigurasi distribusi AMI Konfigurasi distribusi mencakup nama AMI keluaran, pengaturan Wilayah tertentu untuk enkripsi, izin peluncuran Akun AWS, dan, organisasi, dan unit organisasi (OU) yang dapat meluncurkan AMI keluaran, dan konfigurasi lisensi. Konfigurasi distribusi memungkinkan Anda untuk menentukan nama dan deskripsi AMI keluaran Anda, mengizinkan orang lain Akun AWS untuk meluncurkan AMI, menyalin AMI ke akun lain, dan mereplikasi AMI ke Wil AWS ayah lain. Ini juga memungkinkan Anda untuk mengekspor AMI ke Amazon Simple Storage Service (Amazon S3), atau mengkonfigurasi EC2 Fast Launch untuk output AMI Windows. Untuk membuat publik AMI, atur akun terotorisasi izin peluncuran ke `all`. Lihat contoh untuk membuat AMI menjadi publik di EC2**[ModifyImageAttribute](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyImageAttribute.html)**. ------ #### [ Console ] Ikuti langkah-langkah ini untuk membuat konfigurasi distribusi AMI baru di Konsol Manajemen AWS: 1. Buka konsol EC2 Image Builder di [ https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Pilih Setelan ** distribusi ** dari panel navigasi. Ini menunjukkan daftar konfigurasi distribusi yang dibuat di bawah akun Anda. 1. Pilih ** Buat pengaturan distribusi ** di dekat bagian atas ** panel pengaturan ** distribusi. 1. Di ** bagian ** Jenis gambar, pilih jenis ** keluaran ** Amazon Machine Image (AMI). 1. Di ** bagian ** Umum, masukkan ** Nama ** untuk konfigurasi distribusi Anda, dan deskripsi opsional. 1. 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](security-iam-awsmanpol.md#sec-iam-manpol-Ec2ImageBuilderCrossAccountDistributionAccess) 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. 1. 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. 1. 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. 1. 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. 1. Untuk menambahkan setelan distribusi untuk Wilayah lain, pilih Tam ** bah Wilayah**. 1. Pilih ** Buat pengaturan setelah Anda ** selesai. ------ #### [ AWS CLI ] Contoh berikut menunjukkan cara menggunakan **create-distribution-configuration** perintah untuk membuat konfigurasi distribusi baru untuk AMI Anda, menggunakan AWS CLI. 1. **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 file`create-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}}" } ] } ] } ``` 1. **Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.** ``` aws imagebuilder create-distribution-configuration --cli-input-json file://{{create-ami-distribution-configuration.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 (/). Untuk informasi lebih rinci, lihat **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** di Referensi *AWS CLI Perintah*. ------ ## Memperbarui konfigurasi distribusi AMI Anda dapat mengubah konfigurasi distribusi AMI Anda. Namun, perubahan yang Anda buat tidak berlaku untuk sumber daya apa pun yang telah didistribusikan oleh Image Builder. Misalnya, jika Anda telah mendistribusikan AMI ke Wilayah yang kemudian dihapus dari distribusi Anda, AMI yang sudah didistribusikan tetap berada di Wilayah tersebut sampai Anda menghapusnya secara manual. ------ #### [ Konsol Manajemen AWS ] Ikuti langkah-langkah berikut untuk konfigurasi distribusi AMI di Konsol Manajemen AWS: 1. Buka konsol EC2 Image Builder di [ https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Pilih Setelan ** distribusi ** dari panel navigasi. Ini menunjukkan daftar konfigurasi distribusi yang dibuat di bawah akun Anda. 1. Untuk melihat detail atau memperbarui konfigurasi distribusi, pilih ** tautan Nama ** konfigurasi. Ini membuka tampilan detail untuk pengaturan distribusi. **catatan** Anda juga dapat memilih kotak centang di sebelah nama ** Konfigurasi**, lalu pilih ** Lihat detail**. 1. 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, lihat[Membuat konfigurasi distribusi AMI](#create-ami-distribution-config). 1. Setelah selesai, pilih **Simpan perubahan**. ------ #### [ AWS CLI ] Contoh berikut menunjukkan cara menggunakan **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** perintah untuk memperbarui pengaturan distribusi untuk AMI Anda, menggunakan AWS CLI. 1. **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 bernama`update-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" ] } } } ] } ``` 1. **Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.** ``` aws imagebuilder update-distribution-configuration --cli-input-json file://{{update-ami-distribution-configuration.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 (/). Untuk informasi lebih rinci, lihat **[update-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/update-distribution-configuration.html)** di Referensi *AWS CLI Perintah*. Untuk memperbarui tag untuk sumber daya konfigurasi distribusi Anda, lihat [Memberi tanda pada sumber daya](tag-resources.md) bagian ini. ------ ## Contoh: Aktifkan Peluncuran Cepat EC2 dengan template peluncuran untuk AMI keluaran Contoh berikut menunjukkan cara menggunakan **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** perintah dengan template peluncuran untuk membuat pengaturan distribusi yang memiliki EC2 Fast Launch dikonfigurasi untuk AMI Anda, dari AWS CLI. Untuk mengonfigurasi pengaturan Peluncuran Cepat EC2 tanpa template peluncuran, pastikan Anda telah memenuhi semua [Prasyarat Peluncuran Cepat EC2](#ami-distribution-prereqs-fast-launch) sebelum membuat konfigurasi distribusi. 1. **Buat file JSON input CLI** Gunakan alat pengeditan file untuk membuat file JSON dengan kunci seperti yang ditunjukkan pada contoh berikut, ditambah nilai yang valid untuk lingkungan Anda. Contoh ini meluncurkan instance untuk semua sumber daya targetnya secara bersamaan, karena jumlah maksimum peluncuran paralel lebih besar dari jumlah sumber daya target. File ini dinamai `ami-dist-config-win-fast-launch.json` dalam contoh perintah yang ditunjukkan pada langkah berikutnya. ``` { "name": "WinFastLaunchDistribution", "description": "An example of Windows AMI EC2 Fast Launch settings in the distribution configuration.", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "Name {{imagebuilder:buildDate}}", "description": "Includes Windows AMI EC2 Fast Launch settings.", "amiTags": { "KeyName": "Some Value" } }, "fastLaunchConfigurations": [{ "enabled": true, "snapshotConfiguration": { "targetResourceCount": 5 }, "maxParallelLaunches": 6, "launchTemplate": { "launchTemplateId": "lt-0ab1234c56d789012", "launchTemplateVersion": "1" } }], "launchTemplateConfigurations": [{ "launchTemplateId": "lt-0ab1234c56d789012", "setDefaultVersion": true }] }] } ``` **catatan** Anda dapat menentukan al `launchTemplateName` ih-alih `launchTemplateId` di `launchTemplate` bagian, tetapi Anda tidak dapat menentukan nama dan Id. 1. **Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.** ``` aws imagebuilder create-distribution-configuration --cli-input-json file://{{ami-dist-config-win-fast-launch.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 (/). Untuk informasi lebih rinci, lihat **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** di Referensi *AWS CLI Perintah*. ## Contoh: Buat pengaturan distribusi untuk disk VM keluaran dari AWS CLI Contoh berikut menunjukkan cara menggunakan **create-distribution-configuration** perintah untuk membuat pengaturan distribusi yang akan mengekspor disk image VM ke Amazon S3 dengan setiap build gambar. 1. **Buat file JSON input CLI** Anda dapat merampingkan **create-distribution-configuration** perintah yang Anda gunakan di AWS CLI. Untuk melakukan ini, buat file JSON yang berisi semua konfigurasi ekspor yang ingin Anda berikan ke perintah. **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 **[CreateDistributionConfiguration](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateDistributionConfiguration.html)** 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 Per * intah. ke **create-distribution-configuration** perintah sebagai opsi. Berikut adalah ringkasan parameter yang kami tentukan dalam objek `s3ExportConfiguration` JSON untuk contoh ini: + **roleName ** (string, required) — Nama peran yang memberikan Import/Export izin VM untuk mengekspor gambar ke bucket S3 Anda. + **disk ImageFormat ** (string, wajib) - Ekspor gambar disk yang diperbarui ke salah satu format yang didukung berikut: + **Virtual Hard Disk (VHD) ** - Kompatibel dengan Citrix Xen dan produk Hyper-V virtualisasi Microsoft. + **Stream-optimized ESX Virtual Machine Disk (VMDK) ** - Kompatibel dengan VMware ESX dan VMware vSphere versi 4, 5, dan 6. + **Ment ** ah — Format mentah. + **S3bucket ** (string, required) — Bucket S3 tempat menyimpan gambar disk keluaran untuk VM Anda. Simpan file sebagai `export-vm-disks.json`. Gunakan nama file dalam **create-distribution-configuration** perintah. ``` { "name": "example-distribution-configuration-with-vm-export", "description": "example", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "description": "example-with-vm-export" }, "s3ExportConfiguration": { "roleName": "vmimport", "diskImageFormat": "RAW", "s3Bucket": "vm-bucket-export" } }], "clientToken": "abc123def4567ab" } ``` 1. **Jalankan perintah berikut, menggunakan file yang Anda buat sebagai input.** ``` aws imagebuilder create-distribution-configuration --cli-input-json file://{{export-vm-disks.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 (/). Untuk informasi lebih rinci, lihat **[create-distribution-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-distribution-configuration.html)** di Referensi *AWS CLI Perintah*.