Konfigurasikan distribusi AMI dengan template EC2 peluncuran - EC2 Image Builder
Tambahkan template EC2 peluncuran ke pengaturan distribusi AMI dari konsolTambahkan template EC2 peluncuran ke setelan 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 template EC2 peluncuran

Untuk membantu memastikan pengalaman peluncuran yang konsisten untuk Image Builder AMI di akun target dan Wilayah, Anda dapat menentukan templat EC2 peluncuran Amazon di setelan distribusi, menggunakanlaunchTemplateConfigurations. 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 EC2 instance 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 EC2 peluncuran ke pengaturan distribusi AMI dari 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 EC2 peluncuran dari daftar. Jika tidak ada template peluncuran di akun Anda, pilih Buat templat peluncuran baru, yang membuka Template Peluncuran di EC2Dasbor.

    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 EC2 peluncuran ke setelan 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.