Buat pipeline gambar AMI dari AWS CLI

Untuk membuat pipeline gambar dari AWS CLI, jalankan create-image-pipeline perintah dengan opsi konfigurasi yang berlaku untuk pipeline Anda. Anda memiliki opsi untuk membuat file JSON yang berisi semua konfigurasi pipeline Anda, atau untuk menentukan konfigurasi saat runtime. Bagian ini menggunakan metode file konfigurasi JSON untuk menyederhanakan perintah.

Seberapa sering pipeline Anda membuat gambar baru untuk menggabungkan pembaruan yang tertunda dari gambar dasar dan komponen Anda tergantung pada schedule yang telah Anda konfigurasikan. A schedule memiliki atribut berikut:

• scheduleExpression— Tetapkan jadwal kapan pipeline Anda berjalan untuk mengevaluasi pipelineExecutionStartCondition dan menentukan apakah itu harus memulai pembangunan. Jadwal dikonfigurasi dengan ekspresi cron. Untuk informasi selengkapnya tentang cara memformat ekspresi cron di Image Builder, lihatGunakan ekspresi cron di Image Builder.

• pipelineExecutionStartCondition— Menentukan apakah pipeline Anda harus memulai pembangunan. Nilai yang valid meliputi:

  • EXPRESSION_MATCH_ONLY— pipeline Anda akan membangun gambar baru setiap kali ekspresi cron cocok dengan waktu saat ini.

  • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE— pipeline Anda tidak akan memulai pembuatan gambar baru kecuali ada perubahan yang tertunda pada image atau komponen dasar Anda.

Ketika Anda menjalankan create-image-pipeline perintah di AWS CLI, banyak sumber daya konfigurasi adalah opsional. Namun, beberapa sumber daya memiliki persyaratan bersyarat, tergantung pada jenis gambar apa yang dibuat pipa. Pengidentifikasi sumber daya berikut diperlukan untuk pipeline gambar AMI:

• Resep gambar ARN

• Konfigurasi infrastruktur ARN

 

Contoh: Buat gambar Windows 2019

Contoh ini mengonfigurasi pipeline yang dijadwalkan berjalan seminggu sekali pada hari Minggu. File konfigurasi yang ditampilkan pada langkah pertama menggunakan sumber daya yang ada untuk resep gambar, infrastruktur, dan konfigurasi distribusi, bersama dengan pengaturan lain untuk membuat gambar Windows 2019.

1. Buat file konfigurasi (opsional)

   Contoh ini menggunakan file konfigurasi bernama create-image-pipeline.json untuk mengkonfigurasi pengaturan di satu tempat. Atau, Anda dapat menggunakan opsi baris perintah saat menjalankan perintah untuk menentukan semua detail yang ditampilkan di sini di file konfigurasi.

   {
   	"name": "ExampleWindows2019Pipeline",
   	"description": "Builds Windows 2019 Images",
   	"enhancedImageMetadataEnabled": true,
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-example-recipe/2020.12.03",
   	"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
   	"distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration",
   	"imageTestsConfiguration": {
   		"imageTestsEnabled": true,
   		"timeoutMinutes": 60
   	},
   	"schedule": {
   		"scheduleExpression": "cron(0 0 * * SUN *)",
   		"pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE"
   	},
   	"status": "ENABLED"
   }
   

   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. Jalankan perintah untuk membuat gambar

   Contoh ini menggunakan file konfigurasi yang dibuat pada langkah pertama sebagai input ke create-image-pipeline perintah. Atau, Anda dapat menentukan pengaturan dan sumber daya untuk pipeline Anda secara langsung ketika Anda menjalankan perintah. Untuk informasi selengkapnya, lihat create-image-pipeline dalam Referensi AWS CLI .

   aws imagebuilder create-image-pipeline --cli-input-json file://create-image-pipeline.json