Buat komponen dengan AWS CLI - EC2 Image Builder
Buat komponen (AWS CLI)

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

Buat komponen dengan AWS CLI

Bagian ini menjelaskan cara menggunakan perintah Image Builder untuk membuat AWS Task Orchestrator and Executor (AWSTOE) komponen dariAWS Command Line Interface. Untuk membangun komponen, sediakan dokumen komponen aplikasi YAMB. Ini mewakili fase dan langkah yang Anda butuhkan untuk membuat komponen. Untuk membuat dokumen komponen YAMB baru, lihatMembuat dokumen komponen YAMAL.

Buat AWSTOE komponen dengan Image Builder dengan 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://my-s3-bucket/my-path/update-linux-os.yaml
Buat komponen dari dokumen YAMB

Untuk merampingkan create-component perintah yang Anda gunakanAWS 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 di langkah sebelumnya. Pasangan uri kunci-nilai berisi referensi file.

catatan

Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan tindakan 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://my-s3-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"
	}
}
    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.

  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. Sebagai contoh, Windows menggunakan garis miring terbalik (\) sedangkan Linux menggunakan garis miring (/) untuk merujuk ke jalur direktori.

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://my-s3-bucket/my-path/update-windows-os.yaml
Buat komponen dari dokumen YAMB

Untuk merampingkan create-component perintah yang Anda gunakanAWS 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 di langkah sebelumnya. Pasangan uri kunci-nilai berisi referensi file.

catatan

Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan tindakan 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://my-s3-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. Sebagai contoh, Windows menggunakan garis miring terbalik (\) sedangkan Linux menggunakan garis miring (/) untuk merujuk ke jalur direktori.

  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. Sebagai contoh, Windows menggunakan garis miring terbalik (\) sedangkan Linux menggunakan garis miring (/) untuk merujuk ke jalur direktori.

AWSTOEpembuatan versi komponen untuk pembaruan () AWS CLI

AWSTOEnama 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. Versi semantik

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 denganAWS 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 berikutnya.