Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tutorial: Buat pipeline gambar dengan output gambar kontainer Docker dari wizard konsol Image Builder
Tutorial ini memandu Anda melalui pembuatan pipeline otomatis untuk membangun dan memelihara image Docker EC2 Image Builder yang disesuaikan menggunakan wizard konsol Create image pipeline. Untuk membantu Anda menelusuri langkah-langkah secara efisien, pengaturan default digunakan saat tersedia, dan bagian opsional dilewati.
Buat alur kerja pipeline gambar
Langkah 1: Tentukan detail pipa
-
Buka konsol EC2 Image Builder di https://console.aws.amazon.com/imagebuilder/
. -
Untuk mulai membuat pipeline Anda, pilih Buat pipeline gambar.
-
Di bagian Umum, masukkan nama Pipeline Anda (wajib).
-
Di bagian Build jadwal, Anda dapat menyimpan default untuk opsi Jadwal. Perhatikan bahwa Zona Waktu yang ditampilkan untuk jadwal default adalah Waktu Terkoordinasi Universal (UTC). Untuk informasi selengkapnya tentang waktu UTC, dan untuk menemukan offset zona waktu Anda, lihat Singkatan Zona Waktu — Daftar
Seluruh Dunia. Untuk pengaturan pembaruan ketergantungan, pilih J alankan pipeline pada waktu yang dijadwalkan jika ada opsi pembaruan ketergantungan. Pengaturan ini menyebabkan pipeline Anda memeriksa pembaruan sebelum memulai build. Jika tidak ada pembaruan, itu melewatkan pembuatan pipeline yang dijadwalkan.
catatan
Untuk memastikan bahwa pipeline Anda mengenali pembaruan ketergantungan dan build seperti yang diharapkan, Anda harus menggunakan versi semantik (x.x.x) untuk gambar dan komponen dasar Anda. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.
-
Pilih Berikutnya untuk melanjutkan ke langkah berikutnya.
Langkah 2: Pilih resep
-
Image Builder secara default menggunakan resep yang ada di bagian Resep. Untuk pertama kalinya, pilih opsi Buat resep baru.
-
Di bagian Jenis gambar, pilih opsi gambar Docker untuk membuat pipeline kontainer yang akan menghasilkan gambar Docker dan mendistribusikannya ke repositori Amazon ECR di Wilayah target.
-
Di bagian Umum, masukkan kotak wajib berikut:
-
Nama — nama resep Anda
-
Versi — versi resep Anda (gunakan format <major>. <minor>. <patch>, di mana mayor, minor, dan patch adalah nilai integer). Resep baru umumnya dimulai dengan
1.0.0.
-
-
Di bagian Gambar Sumber, pertahankan nilai default untuk Pilih gambar, Sistem Operasi Gambar (OS), dan Gambar asal. Ini menghasilkan daftar gambar kontainer Amazon Linux 2, dikelola oleh Amazon, untuk Anda pilih untuk gambar dasar Anda.
-
Dari dropdown Nama gambar, pilih gambar.
-
Pertahankan default untuk Auto-versioning opsi (Gunakan versi OS terbaru yang tersedia).
catatan
Pengaturan ini memastikan bahwa pipeline Anda menggunakan versi semantik untuk gambar dasar, untuk mendeteksi pembaruan ketergantungan untuk pekerjaan yang dijadwalkan secara otomatis. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.
-
-
Di bagian Komponen, Anda dapat memilih untuk tidak menambahkan komponen apa pun dan melanjutkan. Jika Anda ingin menambahkan komponen, di panel Build components — Amazon Linux, Anda dapat menelusuri komponen yang tercantum di halaman. Gunakan kontrol pagination di sudut kanan atas untuk menavigasi melalui komponen tambahan yang tersedia untuk OS gambar dasar Anda. Anda juga dapat mencari komponen tertentu, atau membuat komponen build Anda sendiri menggunakan Manajer Komponen.
Untuk tutorial ini, pilih komponen yang memperbarui Linux dengan pembaruan keamanan terbaru, sebagai berikut:
-
Filter hasil dengan memasukkan kata
updatedi bilah pencarian yang terletak di bagian atas panel. -
Pilih kotak centang untuk komponen
update-linuxbuild. -
Gulir ke bawah, dan di sudut kanan atas daftar Kompon en yang dipilih, pilih Per luas semua.
-
Pertahankan default untuk opsi Versi (Gunakan versi komponen terbaru yang tersedia).
catatan
Pengaturan ini memastikan bahwa pipeline Anda menggunakan versi semantik untuk komponen yang dipilih, untuk mendeteksi pembaruan ketergantungan untuk pekerjaan yang dijadwalkan secara otomatis. Untuk mempelajari selengkapnya tentang pembuatan versi semantik untuk sumber daya Pembuat Gambar, lihatPembuatan versi semantik di Image Builder.
Jika Anda telah memilih komponen yang memiliki parameter input, Anda juga akan melihat parameter di area ini. Parameter tidak tercakup dalam tutorial ini. Untuk informasi selengkapnya tentang menggunakan parameter input di komponen Anda, dan mengaturnya dalam resep Anda, lihatTutorial: Buat komponen kustom dengan parameter input.
Susun ulang komponen (opsional)
Jika Anda telah memilih lebih dari satu komponen untuk disertakan dalam gambar Anda, Anda dapat menggunakan tindakan drag-and-drop untuk mengatur ulang komponen tersebut ke dalam urutan yang seharusnya dijalankan selama proses pembuatan.
catatan
Komponen pengerasan CIS tidak mengikuti aturan pemesanan komponen standar dalam resep Pembuat Gambar. Komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa tes benchmark berjalan terhadap gambar keluaran Anda.
-
Gulir kembali ke daftar komponen yang tersedia.
-
Pilih kotak centang untuk komponen
update-linux-kernel-mainlinebuild (atau komponen lain pilihan Anda). -
Gulir ke bawah ke daftar komponen yang dipilih, untuk melihat bahwa setidaknya ada dua hasil.
-
Komponen yang baru ditambahkan mungkin tidak memiliki versi yang diperluas. Untuk memperluas opsi Pembuatan Versi, Anda dapat memilih panah di sebelah opsi Pembuatan Versi, atau Anda dapat menonaktifkan dan mengaktifkan tombol Ex pand all untuk memperluas pembuatan versi untuk semua komponen yang dipilih.
-
Pilih salah satu komponen, dan seret ke atas atau ke bawah untuk mengubah urutan komponen akan berjalan.
-
Untuk menghapus
update-linux-kernel-mainlinekomponen, pilihXdari sudut kanan atas kotak komponen. -
Ulangi langkah sebelumnya untuk menghapus komponen lain yang mungkin telah Anda tambahkan, hanya menyisakan
update-linuxkomponen yang dipilih.
-
-
Di bagian template Dockerfile, pilih opsi Gunakan contoh. Di panel Konten, perhatikan variabel kontekstual tempat Image Builder menempatkan informasi atau skrip build, berdasarkan resep gambar kontainer Anda.
Secara default, Image Builder menggunakan variabel kontekstual berikut di Dockerfile Anda.
- ParentImage (wajib)
-
Pada waktu pembuatan, variabel ini diselesaikan ke gambar dasar untuk resep Anda.
Contoh:
FROM {{{ imagebuilder:parentImage }}} - lingkungan (diperlukan jika komponen ditentukan)
-
Pada waktu pembuatan, variabel ini diselesaikan ke arahan Dockerfile yang menempatkan komponen Anda dalam konteks build. Arahan ini menyalin skrip komponen ke dalam gambar dan mengatur variabel lingkungan yang digunakan skrip tersebut. Ini mempersiapkan lingkungan tetapi tidak menjalankan komponen yang Anda tentukan. Tempatkan variabel ini sebelum
componentsvariabel.Contoh:
{{{ imagebuilder:environments }}} - komponen (opsional)
-
Pada waktu pembuatan, variabel ini diselesaikan ke perintah yang menjalankan skrip komponen build dan test untuk komponen yang disertakan resep kontainer, dan kemudian menghapus skrip tersebut dari gambar. Ini adalah variabel yang menjalankan komponen Anda. Tempatkan setelah
environmentsvariabel.Contoh:
{{{ imagebuilder:components }}}
-
Di bagian Repositori target, tentukan nama repositori Amazon ECR yang Anda buat sebagai prasyarat untuk tutorial ini. Repositori ini digunakan sebagai pengaturan default untuk konfigurasi distribusi di Wilayah tempat pipeline berjalan (Wilayah 1).
catatan
Repositori target harus ada di Amazon ECR untuk semua Wilayah target sebelum didistribusikan.
-
Pilih Berikutnya untuk melanjutkan ke langkah berikutnya.
Langkah 3: Tentukan konfigurasi infrastruktur - opsional
Image Builder meluncurkan instans EC2 di akun Anda untuk menyesuaikan gambar dan menjalankan tes validasi. Setelan konfigurasi Infrastruktur menentukan detail infrastruktur untuk instans yang akan berjalan di Anda Akun AWS selama proses pembuatan.
Di bagian Konfigurasi Infrastruktur, opsi Konfigurasi default keCreate infrastructure
configuration using service defaults. Ini membuat peran IAM dan profil instance terkait yang digunakan oleh instance build untuk mengonfigurasi image kontainer Anda. Anda juga dapat membuat konfigurasi infrastruktur kustom Anda sendiri, atau menggunakan pengaturan yang telah Anda buat. Untuk informasi selengkapnya tentang pengaturan konfigurasi infrastruktur, lihat CreateInfrastructureConfiguration Refer ensi API EC2 Image Builder.
Untuk tutorial ini, kita menggunakan pengaturan default.
-
Pilih Berikutnya untuk melanjutkan ke langkah berikutnya.
Langkah 4: Tentukan pengaturan distribusi - opsional
Pengaturan distribusi terdiri dari Regions target, dan nama repositori Amazon ECR target. Gambar Output Docker digunakan ke repositori Amazon ECR bernama di setiap Wilayah.
Di bagian Pengaturan distribusi, opsi Konfigurasi default keCreate distribution settings using service
defaults. Opsi ini akan mendistribusikan gambar Docker keluaran ke repositori Amazon ECR yang ditentukan dalam resep kontainer Anda untuk Wilayah tempat pipeline Anda berjalan (Wilayah 1). Jika Anda memilihCreate new distribution settings, Anda dapat mengganti repositori ECR untuk Wilayah saat ini, dan menambahkan lebih banyak Wilayah untuk distribusi.
Untuk tutorial ini, kita menggunakan pengaturan default.
-
Pilih Berikutnya untuk melanjutkan ke langkah berikutnya.
Langkah 5: Tinjau
Bagian Review menampilkan semua pengaturan yang telah Anda konfigurasi. Untuk mengedit informasi di bagian tertentu, pilih tombol Edit yang terletak di sudut kanan atas bagian langkah. Misalnya, jika Anda ingin mengubah nama pipeline Anda, pilih tombol Edit di sudut kanan atas bagian Langkah 1: Rincian pipa.
-
Setelah Anda meninjau pengaturan Anda, pilih Buat pipeline untuk membuat pipeline Anda.
-
Anda dapat melihat pesan sukses atau gagal di bagian atas halaman, karena sumber daya Anda dibuat untuk pengaturan distribusi, konfigurasi infrastruktur, resep baru Anda, dan pipeline. Untuk melihat detail sumber daya, termasuk pengidentifikasi sumber daya, pilih Lihat detail.
-
Setelah Anda melihat detail untuk sumber daya, Anda dapat melihat detail tentang sumber daya lain dengan memilih jenis sumber daya dari panel navigasi. Misalnya, untuk melihat detail untuk pipeline baru Anda, pilih Pipeline gambar dari panel navigasi. Jika build Anda berhasil, pipeline baru Anda ditampilkan dalam daftar saluran pipa gambar.
Langkah 6: Bersihkan
Lingkungan Pembuat Gambar Anda, sama seperti rumah Anda, membutuhkan perawatan rutin untuk membantu Anda menemukan apa yang Anda butuhkan, dan menyelesaikan tugas Anda tanpa mengarungi kekacauan. Pastikan untuk secara teratur membersihkan sumber daya sementara yang Anda buat untuk pengujian. Jika tidak, Anda mungkin melupakan sumber daya itu, dan kemudian, tidak ingat untuk apa mereka digunakan. Pada saat itu, mungkin tidak jelas apakah Anda dapat menyingkirkannya dengan aman.
Tip
Untuk mencegah kesalahan ketergantungan saat Anda menghapus sumber daya, pastikan untuk menghapus sumber daya Anda dalam urutan berikut:
-
Pipa gambar
-
Resep gambar
-
Semua sumber daya yang tersisa
Untuk membersihkan sumber daya yang Anda buat untuk tutorial ini, ikuti langkah-langkah berikut:
Hapus pipa
-
Untuk melihat daftar pipeline build yang dibuat di bawah akun Anda, pilih Pipel ine gambar dari panel navigasi.
-
Pilih kotak centang di sebelah nama Pipeline untuk memilih pipeline yang ingin Anda hapus.
-
Di bagian atas panel Image pipeline, pada menu Ac tions, pilih Delete.
-
Untuk mengonfirmasi penghapusan, masukkan
Deletedalam kotak, dan pilih H apus.
Hapus resep wadah
-
Untuk melihat daftar resep wadah yang dibuat di bawah akun Anda, pilih Resep kontainer dari panel navigasi.
-
Pilih kotak centang di samping Nama resep untuk memilih resep yang ingin Anda hapus.
-
Di bagian atas panel resep kon tainer, pada menu Tind akan, pilih H apus resep.
-
Untuk mengonfirmasi penghapusan, masukkan
Deletedalam kotak, dan pilih H apus.
Hapus konfigurasi infrastruktur
-
Untuk melihat daftar konfigurasi infrastruktur yang dibuat di bawah akun Anda, pilih Konfigurasi infrastruktur dari panel navigasi.
-
Pilih kotak centang di samping Nama konfigurasi untuk memilih konfigurasi infrastruktur yang ingin Anda hapus.
-
Di bagian atas panel Konfigurasi Infrastruktur, pilih H apus.
-
Untuk mengonfirmasi penghapusan, masukkan
Deletedalam kotak, dan pilih H apus.
Hapus pengaturan distribusi
-
Untuk melihat daftar pengaturan distribusi yang dibuat di bawah akun Anda, pilih Peng aturan distribusi dari panel navigasi.
-
Pilih kotak centang di samping Nama konfigurasi untuk memilih pengaturan distribusi yang Anda buat untuk tutorial ini.
-
Di bagian atas panel pengaturan Distribusi, pilih H apus.
-
Untuk mengonfirmasi penghapusan, masukkan
Deletedalam kotak, dan pilih H apus.
Hapus gambar
Ikuti langkah-langkah ini untuk memverifikasi bahwa Anda telah menghapus gambar apa pun yang dibuat dari pipeline tutorial. Tutorial ini tidak mungkin membuat gambar kecuali cukup waktu telah berlalu sejak Anda membuat pipeline yang dijalankan, sesuai dengan jadwal pembuatan.
-
Untuk melihat daftar gambar yang dibuat di bawah akun Anda, pilih Gambar dari panel navigasi.
-
Pilih versi gambar untuk gambar yang ingin Anda hapus. Ini membuka halaman versi pembuatan gambar.
-
Pilih kotak centang di samping Versi untuk gambar apa pun yang ingin Anda hapus. Anda dapat memilih lebih dari satu versi gambar pada satu waktu.
-
Di bagian atas panel versi build gambar, pilih H apus versi.
-
Untuk mengonfirmasi penghapusan, masukkan
Deletedalam kotak, dan pilih H apus.