Konfigurasikan distribusi AMI dengan templat peluncuran EC2 - EC2 Image Builder
Tambahkan template peluncuran EC2 ke pengaturan distribusi AMI dari konsolTambahkan template peluncuran EC2 ke pengaturan distribusi AMI dari AWS CLI

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

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.

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

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

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

  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 EC2 ke pengaturan distribusi AMI dari 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, 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, 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 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 (\) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

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