Konfigurasikan setelan distribusi AMI untuk menggunakan templat peluncuran Amazon EC2

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

• Luncurkan instance Windows dari template peluncuran

Tambahkan template peluncuran Amazon EC2 ke pengaturan distribusi AMI Anda (konsol)

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

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

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

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

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

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

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

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

Tambahkan template peluncuran Amazon EC2 ke pengaturan distribusi AMI Anda () AWS CLI

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, menggunakanAWS 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, bernamacreate-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"
   }

2. Buat pengaturan distribusi

   Untuk membuat sumber daya pengaturan distribusi Image Builder menggunakan create-distribution-configurationperintah diAWS 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. Sebagai contoh, Windows menggunakan garis miring terbalik (\) sedangkan Linux menggunakan garis miring (/) untuk merujuk ke jalur direktori.

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