Buat komponen kustom dengan Image Builder - EC2 Image Builder
Buat komponen khusus dari konsolBuat komponen khusus dari AWS CLIImpor skrip untuk membuat komponen dari AWS CLIManajemen versi build otomatisMenggunakan referensi versi

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

Buat komponen kustom dengan Image Builder

Setelah menyelesaikan dokumen komponen, Anda dapat menggunakannya untuk membuat komponen kustom yang dapat digunakan resep Image Builder Anda. Anda dapat membuat komponen kustom dari konsol Image Builder, dari API atau SDKs, atau dari baris perintah. Untuk informasi selengkapnya tentang cara membuat komponen kustom dengan parameter input dan menggunakannya dalam resep Anda, lihatTutorial: Buat komponen kustom dengan parameter input.

Bagian berikut menunjukkan cara membuat komponen dari konsol atau dari AWS CLI.

Buat komponen khusus dari konsol

Untuk membuat komponen AWSTOE aplikasi dari konsol Image Builder, ikuti langkah-langkah berikut:

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

  2. Pilih Komponen dari panel navigasi. Kemudian pilih Buat komponen.

  3. Pada halaman Create component, di bawah Component details, masukkan yang berikut ini:

    1. Gambar Sistem operasi (OS). Tentukan sistem operasi yang kompatibel dengan komponen tersebut.

    2. Kategori komponen. Dari dropdown, pilih jenis komponen build atau test yang Anda buat.

    3. Nama komponen. Masukkan nama untuk komponen.

    4. Versi komponen. Masukkan nomor versi komponen.

    5. Deskripsi. Berikan deskripsi opsional untuk membantu Anda mengidentifikasi komponen.

    6. Ubah deskripsi. Berikan deskripsi opsional untuk membantu Anda memahami perubahan yang dibuat pada versi komponen ini.

  4. Di bagian Dokumen definisi, opsi defaultnya adalah Tentukan konten dokumen. Dokumen komponen mendefinisikan tindakan yang dilakukan Image Builder pada instance build dan pengujian untuk membuat image Anda.

    Di kotak Konten, masukkan konten dokumen komponen YAMB Anda. Untuk memulai dengan contoh Hello World untuk Linux, pilih opsi Use example. Untuk mempelajari lebih lanjut tentang cara membuat dokumen komponen YAMB, atau menyalin dan menempelkan contoh UpdateOS dari halaman tersebut, lihat. Membuat dokumen komponen YAMAL untuk komponen kustom di Image Builder

  5. Setelah Anda memasukkan detail komponen, pilih Buat komponen.

    catatan

    Untuk melihat komponen baru Anda saat membuat atau memperbarui resep, terapkan filter Owned by me ke daftar komponen build atau test. Filter terletak di bagian atas daftar komponen, di sebelah kotak pencarian.

  6. Untuk menghapus komponen, dari halaman Komponen, pilih kotak centang di sebelah komponen yang ingin Anda hapus. Dari dropdown Tindakan, pilih Hapus komponen.

Perbarui komponen

Untuk membuat versi komponen baru, ikuti langkah-langkah berikut:

  1. Tergantung di mana Anda memulai:

    • Dari halaman daftar Komponen - Pilih kotak centang di sebelah nama komponen, lalu pilih Buat versi baru dari menu Tindakan.

    • Dari halaman detail komponen - Pilih tombol Buat versi baru di sudut kanan atas judul.

  2. Informasi komponen sudah diisi dengan nilai saat ini saat halaman Create Component ditampilkan. Ikuti langkah-langkah membuat komponen untuk memperbarui komponen. Ini memastikan bahwa Anda memasukkan versi semantik unik dalam versi Komponen. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. Pembuatan versi semantik di Image Builder

Buat komponen khusus dari AWS CLI

Di bagian ini, Anda akan belajar cara mengatur dan menggunakan perintah Image Builder di AWS CLI untuk membuat komponen AWSTOE aplikasi, sebagai berikut.

  • Unggah dokumen komponen YAMB Anda ke bucket S3 yang dapat Anda referensikan dari baris perintah.

  • Buat komponen AWSTOE aplikasi dengan create-component perintah.

  • Daftar versi komponen dengan list-components perintah dan filter nama untuk melihat versi apa yang sudah ada. Anda dapat menggunakan output untuk menentukan versi berikutnya untuk pembaruan.

Untuk membuat komponen AWSTOE aplikasi dari dokumen YAMM masukan, ikuti langkah-langkah yang sesuai dengan platform sistem operasi gambar Anda.

Linux
Simpan dokumen komponen aplikasi Anda di Amazon S3

Anda dapat menggunakan bucket S3 sebagai repositori untuk dokumen sumber komponen AWSTOE aplikasi Anda. Untuk menyimpan dokumen komponen Anda, ikuti langkah-langkah berikut:

  • Unggah dokumen ke Amazon S3

    Jika dokumen Anda lebih kecil dari 64 KB, Anda dapat melewati langkah ini. Dokumen yang berukuran 64 KB atau lebih besar harus disimpan di Amazon S3.

    aws s3 cp update-linux-os.yaml s3://amzn-s3-demo-destination-bucket/my-path/update-linux-os.yaml
Buat komponen dari dokumen YAMB

Untuk merampingkan create-component perintah yang Anda gunakan di AWS CLI, buat file JSON yang berisi semua parameter komponen yang ingin Anda lewatkan ke perintah. Sertakan lokasi update-linux-os.yaml dokumen yang Anda buat sebelumnya. Pasangan uri kunci-nilai berisi referensi file.

catatan

Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan operasi Image Builder API. Untuk meninjau parameter permintaan perintah API, lihat CreateComponentperintah di Referensi API EC2 Image Builder.

Untuk memberikan nilai data sebagai parameter baris perintah, lihat nama parameter yang ditentukan dalam Referensi AWS CLI Perintah.

  1. Buat file JSON input CLI

    Gunakan alat pengeditan file untuk membuat file bernamacreate-update-linux-os-component.json. Sertakan konten berikut:

    {
	"name": "update-linux-os",
	"semanticVersion": "1.1.2",
	"description": "An example component that updates the Linux operating system",
	"changeDescription": "Initial version.",
	"platform": "Linux",
	"uri": "s3://amzn-s3-demo-destination-bucket/my-path/update-linux-os.yaml",
	"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/98765432-b123-456b-7f89-0123456f789c",
	"tags": {
		"MyTagKey-purpose": "security-updates"
	}
}
  2. Buat komponen

    Gunakan perintah berikut untuk membuat komponen, merujuk nama file untuk file JSON yang Anda buat pada langkah sebelumnya:

    aws imagebuilder create-component --cli-input-json file://create-update-linux-os-component.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 (/).

Windows
Simpan dokumen komponen aplikasi Anda di Amazon S3

Anda dapat menggunakan bucket S3 sebagai repositori untuk dokumen sumber komponen AWSTOE aplikasi Anda. Untuk menyimpan dokumen komponen Anda, ikuti langkah-langkah berikut:

  • Unggah dokumen ke Amazon S3

    Jika dokumen Anda lebih kecil dari 64 KB, Anda dapat melewati langkah ini. Dokumen yang berukuran 64 KB atau lebih besar harus disimpan di Amazon S3.

    aws s3 cp update-windows-os.yaml s3://amzn-s3-demo-destination-bucket/my-path/update-windows-os.yaml
Buat komponen dari dokumen YAMB

Untuk merampingkan create-component perintah yang Anda gunakan di AWS CLI, buat file JSON yang berisi semua parameter komponen yang ingin Anda lewatkan ke perintah. Sertakan lokasi update-windows-os.yaml dokumen yang Anda buat sebelumnya. Pasangan uri kunci-nilai berisi referensi file.

catatan

Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan operasi Image Builder API. Untuk meninjau parameter permintaan perintah API, lihat CreateComponentperintah di Referensi API EC2 Image Builder.

Untuk memberikan nilai data sebagai parameter baris perintah, lihat nama parameter yang ditentukan dalam Referensi AWS CLI Perintah..

  1. Buat file JSON input CLI

    Gunakan alat pengeditan file untuk membuat file bernamacreate-update-windows-os-component.json. Sertakan konten berikut:

    {
	"name": "update-windows-os",
	"semanticVersion": "1.1.2",
	"description": "An example component that updates the Windows operating system.",
	"changeDescription": "Initial version.",
	"platform": "Windows",
	"uri": "s3://amzn-s3-demo-destination-bucket/my-path/update-windows-os.yaml",
	"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/98765432-b123-456b-7f89-0123456f789c",
	"tags": {
		"MyTagKey-purpose": "security-updates"
	}
}
    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 (/).

  2. Buat komponen

    Gunakan perintah berikut untuk membuat komponen, merujuk nama file untuk file JSON yang Anda buat pada langkah sebelumnya:

    aws imagebuilder create-component --cli-input-json file://create-update-windows-os-component.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 (/).

macOS
Simpan dokumen komponen aplikasi Anda di Amazon S3

Anda dapat menggunakan bucket S3 sebagai repositori untuk dokumen sumber komponen AWSTOE aplikasi Anda. Untuk menyimpan dokumen komponen Anda, ikuti langkah-langkah berikut:

  • Unggah dokumen ke Amazon S3

    Jika dokumen Anda lebih kecil dari 64 KB, Anda dapat melewati langkah ini. Dokumen yang berukuran 64 KB atau lebih besar harus disimpan di Amazon S3.

    aws s3 cp wget-macos.yaml s3://amzn-s3-demo-destination-bucket/my-path/wget-macos.yaml
Buat komponen dari dokumen YAMB

Untuk merampingkan create-component perintah yang Anda gunakan di AWS CLI, buat file JSON yang berisi semua parameter komponen yang ingin Anda lewatkan ke perintah. Sertakan lokasi wget-macos.yaml dokumen yang Anda buat sebelumnya. Pasangan uri kunci-nilai berisi referensi file.

catatan

Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan operasi Image Builder API. Untuk meninjau parameter permintaan perintah API, lihat CreateComponentperintah di Referensi API EC2 Image Builder.

Untuk memberikan nilai data sebagai parameter baris perintah, lihat nama parameter yang ditentukan dalam Referensi AWS CLI Perintah.

  1. Buat file JSON input CLI

    Gunakan alat pengeditan file untuk membuat file bernamainstall-wget-macos-component.json. Sertakan konten berikut:

    {
	"name": "install install-wget-macos-component",
	"semanticVersion": "1.1.2",
	"description": "An example component that installs and verifies the wget utility on macOS.",
	"changeDescription": "Initial version.",
	"platform": "macOS",
	"uri": "s3://amzn-s3-demo-destination-bucket/my-path/wget-macos.yaml",
	"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/98765432-b123-456b-7f89-0123456f789c",
	"tags": {
		"MyTagKey-purpose": "install-software"
	}
}
  2. Buat komponen

    Gunakan perintah berikut untuk membuat komponen, merujuk nama file untuk file JSON yang Anda buat pada langkah sebelumnya:

    aws imagebuilder create-component --cli-input-json file://install-wget-macos-component.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 (/).

AWSTOE versi komponen untuk pembaruan dari AWS CLI

AWSTOE nama dan versi komponen disematkan di Amazon Resource Name (ARN) komponen, setelah awalan komponen. Setiap versi baru komponen memiliki ARN uniknya sendiri. Langkah-langkah untuk membuat versi baru persis sama dengan langkah-langkah untuk membuat komponen baru, selama versi semantik unik untuk nama komponen itu. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. Pembuatan versi semantik di Image Builder

Untuk memastikan bahwa Anda menetapkan versi logis berikutnya, pertama-tama dapatkan daftar versi yang ada untuk komponen yang ingin Anda ubah. Gunakan list-components perintah dengan AWS CLI, dan filter pada nama.

Dalam contoh ini, Anda memfilter nama komponen yang Anda buat di contoh Linux sebelumnya. Untuk membuat daftar komponen yang Anda buat, gunakan nilai name parameter dari file JSON yang Anda gunakan dalam create-component perintah.

aws imagebuilder list-components --filters name="name",values="update-linux-os"	
{
    "requestId": "123a4567-b890-123c-45d6-ef789ab0cd1e",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:1234560087789012:component/update-linux-os/1.0.0",
            "name": "update-linux-os",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:1234560087789012:component/update-linux-os/1.0.1",
            "name": "update-linux-os",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}

Berdasarkan hasil Anda, Anda dapat menentukan versi apa yang seharusnya.

Impor skrip untuk membuat komponen dari AWS CLI

Untuk beberapa skenario, mungkin lebih mudah untuk memulai dengan skrip yang sudah ada sebelumnya. Untuk skenario ini, Anda dapat menggunakan contoh berikut.

Contoh ini mengasumsikan bahwa Anda memiliki file bernama import-component.json (seperti yang ditunjukkan). Perhatikan bahwa file tersebut secara langsung mereferensikan PowerShell skrip AdminConfig.ps1 yang disebut yang sudah diunggah. amzn-s3-demo-source-bucket Saat SHELL ini, didukung untuk komponenformat. 

{
"name": "MyImportedComponent",
"semanticVersion": "1.0.0",
"description": "An example of how to import a component",
"changeDescription": "First commit message.",
"format": "SHELL",
"platform": "Windows",
"type": "BUILD",
"uri": "s3://amzn-s3-demo-source-bucket/AdminConfig.ps1",
"kmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/60763706-b131-418b-8f85-3420912f020c"
}

Untuk membuat komponen dari skrip yang diimpor, jalankan perintah berikut.

aws imagebuilder import-component --cli-input-json file://import-component.json

Manajemen versi build otomatis

Saat Anda membuat komponen dengan nama dan versi semantik yang sama dengan komponen yang ada, Image Builder secara otomatis menambah versi build (misalnya, dari /1 ke, ke /2/3, dan seterusnya). Ini memungkinkan Anda untuk membuat pembaruan berulang pada komponen Anda tanpa mengelola nomor versi secara manual, yang sangat berguna dalam CI/CD pipeline dan infrastructure-as-code penerapan. Jika konten komponen identik dengan versi build sebelumnya, Image Builder kembali ResourceAlreadyExistsException untuk mencegah duplikat komponen menggunakan kuota layanan Anda.

Menggunakan referensi versi

Ketika Anda membuat atau mengambil komponen, Image Builder secara otomatis menyediakan pra-konstruksi ARNs dengan pola versi wildcard dalam objek. latestVersionReferences Referensi ini memudahkan penggunaan versi terbaru komponen Anda dalam resep dan saluran pipa tanpa mengurai ARNs secara manual.

Memilih referensi versi yang tepat

  • latestVersionArn (x.xx) - Selalu gunakan versi komponen terbaru mutlak.

  • atestMajorVersionArn (1.xx) - Gunakan versi minor dan patch terbaru dalam versi utama.

  • latestMinorVersionArn (1.2.x) - Gunakan versi patch terbaru saja.

  • latestPatchVersionArn (1.2.3) - Referensikan versi semantik tertentu, tetapi dapatkan versi build terbaru.