Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Konfigurasikan distribusi AMI dengan templat peluncuran EC2
<a name="dist-using-launch-template"></a>

Untuk membantu memastikan pengalaman peluncuran yang konsisten untuk Image Builder AMI di akun target dan Wilayah, Anda dapat menentukan templat peluncuran Amazon EC2 di setelan distribusi, menggunakan. `launchTemplateConfigurations` Ketika `launchTemplateConfigurations` hadir selama proses distribusi, Image Builder membuat versi baru dari template peluncuran yang mencakup semua pengaturan asli dari template, dan ID AMI baru dari build. Untuk informasi selengkapnya tentang meluncurkan instans EC2 menggunakan template peluncuran, lihat salah satu tautan berikut, tergantung pada sistem operasi target Anda.
+ [Luncurkan instance Linux dari template peluncuran](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
+ [Luncurkan instance Windows dari template peluncuran](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)

**catatan**  
Ketika Anda menyertakan template peluncuran untuk mengaktifkan Windows Fast Launch dalam gambar Anda, template peluncuran harus menyertakan tag berikut sehingga Image Builder dapat mengaktifkan Windows Fast Launch atas nama Anda.  
`CreatedBy: EC2 Image Builder`

## Tambahkan template peluncuran EC2 ke pengaturan distribusi AMI dari konsol
<a name="dist-using-launch-template-console"></a>

Untuk menyediakan template peluncuran dengan AMI keluaran Anda, ikuti langkah-langkah berikut di konsol:

1. Buka konsol [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder di.

1. Pilih **Pengaturan distribusi** dari panel navigasi. Ini menunjukkan daftar pengaturan distribusi yang dibuat di bawah akun Anda.

1. Di bagian atas halaman **Pengaturan distribusi**, pilih **Buat pengaturan distribusi**. Ini membuka halaman **Buat pengaturan distribusi**.

1. Di bagian **Jenis gambar**, pilih **jenis Output** **Amazon Machine Image (AMI)**. Ini adalah pengaturan default.

1. Di bagian **Umum**, masukkan **Nama** sumber daya pengaturan distribusi yang ingin Anda buat (*wajib*).

1. Di bagian **Pengaturan wilayah**, pilih nama templat peluncuran EC2 dari daftar. Jika tidak ada template peluncuran di akun Anda, pilih **Buat templat peluncuran baru, yang membuka Template** **Peluncuran** di **Dasbor EC2**.

   Pilih kotak centang **Setel versi default** untuk memperbarui versi default template peluncuran ke versi baru yang dibuat Image Builder dengan AMI keluaran Anda.

   Untuk menambahkan templat peluncuran lain ke Wilayah yang dipilih, pilih **Tambahkan konfigurasi templat peluncuran**.

   Untuk menghapus template peluncuran, pilih **Hapus**.

1. Lanjutkan menentukan pengaturan tambahan apa pun yang Anda perlukan, dan pilih **Buat pengaturan** untuk membuat sumber daya pengaturan distribusi baru Anda.

## Tambahkan template peluncuran EC2 ke pengaturan distribusi AMI dari AWS CLI
<a name="dist-using-launch-template-cli"></a>

Bagian ini menjelaskan cara mengonfigurasi file pengaturan distribusi dengan template peluncuran, dan menggunakan **create-image** perintah di AWS CLI untuk membangun dan mendistribusikan Image Builder AMI dan versi baru dari template peluncuran yang menggunakannya.

1. 

**Konfigurasikan file pengaturan distribusi**

   Sebelum Anda dapat membuat Image Builder AMI dengan template peluncuran, menggunakan AWS CLI, Anda harus membuat struktur JSON konfigurasi distribusi yang menentukan pengaturan. `launchTemplateConfigurations` Anda harus menentukan setidaknya satu `launchTemplateConfigurations` entri di Wilayah sumber.

   File contoh berikut, bernama`create-distribution-config-launch-template.json`, menunjukkan beberapa skenario yang mungkin untuk konfigurasi template peluncuran di Wilayah sumber.

   ```
   {
       "name": "NewDistributionConfiguration",
       "description": "This is just a test",
       "distributions": [
           {
               "region": "us-west-2",
               "amiDistributionConfiguration": {
                   "name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}",
                   "description": "description"
               },
               "launchTemplateConfigurations": [
                   {
                       "launchTemplateId": "lt-0a1bcde2fgh34567",
                       "accountId": "935302948087",
                       "setDefaultVersion": true
                   },
                   {
                       "launchTemplateId": "lt-0aaa1bcde2ff3456"
                   },
                   {
                       "launchTemplateId": "lt-12345678901234567",
                       "accountId": "123456789012"
                   }
               ]
           }
       ],
       "clientToken": "clientToken1"
   }
   ```

1. 

**Buat pengaturan distribusi**

   Untuk membuat sumber daya pengaturan distribusi Image Builder menggunakan [create-distribution-configuration](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-distribution-configuration.html)perintah di AWS CLI, berikan parameter berikut dalam perintah:
   + Masukkan nama distribusi dalam `--name` parameter.
   + Lampirkan file JSON konfigurasi distribusi yang Anda buat di `--cli-input-json` parameter.

   ```
   aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.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 (\$1) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

*Anda juga dapat memberikan JSON langsung dalam perintah, menggunakan `--distributions` parameter.*