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 EC2 Image Builder Docker 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.
**Topics**
+ [Langkah 1: Tentukan detail pipa](#start-build-container-step1)
+ [Langkah 2: Pilih resep](#start-build-container-step2)
+ [Langkah 3: Tentukan konfigurasi infrastruktur - opsional](#start-build-container-step3)
+ [Langkah 4: Tentukan pengaturan distribusi - opsional](#start-build-container-step4)
+ [Langkah 5: Tinjau](#start-build-container-step5)
+ [Langkah 6: Bersihkan](#start-build-container-cleanup)
## Langkah 1: Tentukan detail pipa
1. Buka konsol [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)EC2 Image Builder di.
1. Untuk mulai membuat pipeline, pilih **Create image pipeline**.
1. Di bagian **Umum**, masukkan **nama Pipeline** Anda (*wajib*).
1. **Di bagian **Jadwal pembuatan**, Anda dapat menyimpan default untuk opsi Jadwal.** Perhatikan bahwa **zona waktu** yang ditampilkan untuk jadwal default adalah Universal Coordinated Time (UTC). Untuk informasi selengkapnya tentang waktu UTC, dan untuk menemukan offset untuk zona waktu Anda, lihat [Singkatan Zona Waktu —](https://www.timeanddate.com/time/zones/) Daftar Seluruh Dunia.
Untuk **pengaturan pembaruan Dependensi**, pilih **Run pipeline pada waktu yang dijadwalkan jika ada opsi pembaruan ketergantungan**. Pengaturan ini menyebabkan pipeline Anda memeriksa pembaruan sebelum memulai pembuatan. Jika tidak ada pembaruan, itu melewatkan pembuatan pipeline terjadwal.
**catatan**
Untuk memastikan bahwa pipeline mengenali pembaruan dan build dependensi seperti yang diharapkan, Anda harus menggunakan versi semantik (x.xx) untuk image dan komponen dasar Anda. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)
1. Pilih **Berikutnya** untuk melanjutkan ke langkah berikutnya.
## Langkah 2: Pilih resep
1. **Image Builder default **menggunakan resep yang ada di bagian Resep**.** Untuk pertama kalinya, pilih opsi **Buat resep baru**.
1. Di bagian **Jenis gambar, pilih opsi image** **Docker** untuk membuat pipeline kontainer yang akan menghasilkan image Docker dan mendistribusikannya ke repositori Amazon ECR di Wilayah target.
1. Di bagian **Umum**, masukkan kotak yang diperlukan berikut:
+ **Nama — nama** resep Anda
+ **Versi — versi** resep Anda (gunakan formatnya *. . *, di mana mayor, minor, dan patch adalah nilai integer). Resep baru umumnya dimulai dengan`1.0.0`.
1. Di bagian **Source image**, pertahankan nilai default untuk **Select image, Image** **Operating System (OS)**, dan **Image origin**. Ini menghasilkan daftar gambar kontainer Amazon Linux 2, yang dikelola oleh Amazon, untuk Anda pilih untuk gambar dasar Anda.
1. Dari dropdown **Nama gambar**, pilih gambar.
1. Pertahankan default untuk **opsi Auto-versioning** (**Gunakan versi OS terbaru yang tersedia**).
**catatan**
Pengaturan ini memastikan bahwa pipeline Anda menggunakan versi semantik untuk image dasar, untuk mendeteksi pembaruan dependensi untuk pekerjaan yang dijadwalkan secara otomatis. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)
1. 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 sendiri menggunakan Component manager.
Untuk tutorial ini, pilih komponen yang memperbarui Linux dengan pembaruan keamanan terbaru, sebagai berikut:
1. Filter hasil dengan memasukkan kata `update` di bilah pencarian yang terletak di bagian atas panel.
1. Pilih kotak centang untuk komponen `update-linux` build.
1. Gulir ke bawah, dan di sudut kanan atas daftar **Komponen yang dipilih**, pilih **Perluas semua**.
1. Pertahankan default untuk **opsi Pembuatan Versi** (**Gunakan versi komponen terbaru yang tersedia**).
**catatan**
Pengaturan ini memastikan bahwa pipeline Anda menggunakan versi semantik untuk komponen yang dipilih, untuk mendeteksi pembaruan dependensi untuk pekerjaan yang dijadwalkan secara otomatis. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)
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 penggunaan parameter input dalam komponen Anda, dan menyetelnya di resep, lihat[Tutorial: Buat komponen kustom dengan parameter input](tutorial-component-parameters.md).
**Menyusun ulang komponen (opsional)**
Jika Anda telah memilih lebih dari satu komponen untuk disertakan dalam gambar Anda, Anda dapat menggunakan drag-and-drop tindakan untuk mengatur ulang mereka ke dalam urutan yang harus dijalankan selama proses build.
**catatan**
Komponen pengerasan CIS tidak mengikuti aturan pemesanan komponen standar dalam resep Image Builder. Komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa tes benchmark berjalan terhadap gambar keluaran Anda.
1. Gulir kembali ke daftar komponen yang tersedia.
1. Pilih kotak centang untuk komponen `update-linux-kernel-mainline` build (atau komponen lain pilihan Anda).
1. Gulir ke bawah ke daftar **Komponen yang dipilih**, untuk melihat bahwa setidaknya ada dua hasil.
1. Komponen yang baru ditambahkan mungkin versinya tidak diperluas. Untuk memperluas **opsi Pembuatan Versi**, Anda dapat memilih panah di samping **opsi Pembuatan Versi**, atau Anda dapat mematikan dan mengaktifkan tombol **Perluas semua untuk memperluas** versi untuk semua komponen yang dipilih.
1. Pilih salah satu komponen, dan seret ke atas atau ke bawah untuk mengubah urutan komponen akan berjalan.
1. Untuk menghapus `update-linux-kernel-mainline` komponen, pilih `X` dari sudut kanan atas kotak komponen.
1. Ulangi langkah sebelumnya untuk menghapus komponen lain yang mungkin telah Anda tambahkan, hanya menyisakan `update-linux` komponen yang dipilih.
1. 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 menyelesaikan gambar dasar untuk resep Anda.
Contoh:
```
FROM
{{{ imagebuilder:parentImage }}}
```
**lingkungan (diperlukan jika komponen ditentukan)**
Variabel ini akan menyelesaikan skrip yang menjalankan komponen.
Contoh:
```
{{{ imagebuilder:environments }}}
```
**komponen (opsional)**
Image Builder menyelesaikan skrip komponen build dan test untuk komponen yang disertakan dalam resep container. Variabel ini dapat ditempatkan di mana saja di Dockerfile, setelah variabel lingkungan.
Contoh:
```
{{{ imagebuilder:components }}}
```
1. 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 distribusi.
1. 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 pengujian validasi. Pengaturan konfigurasi Infrastruktur menentukan detail infrastruktur untuk instans yang akan berjalan di Anda Akun AWS selama proses pembuatan.
Di bagian **konfigurasi Infrastruktur**, **opsi Konfigurasi** default ke`Create infrastructure configuration using service defaults`. Ini membuat peran IAM dan profil instance terkait yang digunakan oleh instance build untuk mengonfigurasi gambar kontainer Anda. Anda juga dapat membuat konfigurasi infrastruktur kustom Anda sendiri, atau menggunakan pengaturan yang telah Anda buat. Untuk informasi selengkapnya tentang setelan konfigurasi infrastruktur, lihat [CreateInfrastructureConfiguration](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateInfrastructureConfiguration.html)di Referensi *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 Wilayah target, dan nama repositori Amazon ECR target. Gambar Output Docker disebarkan ke repositori Amazon ECR bernama di setiap Wilayah.
Di bagian **Pengaturan distribusi**, **opsi Konfigurasi** default ke`Create distribution settings using service defaults`. Opsi ini akan mendistribusikan image Docker keluaran ke repositori Amazon ECR yang ditentukan dalam resep container Anda untuk Wilayah tempat pipeline Anda berjalan (Wilayah 1). Jika Anda memilih`Create 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 konfigurasikan. Untuk mengedit informasi di bagian mana pun, pilih tombol **Edit** yang terletak di sudut kanan atas bagian langkah. Misalnya, jika Anda ingin mengubah nama pipeline, pilih tombol **Edit** di sudut kanan atas bagian **Langkah 1: Detail saluran pipa**.
1. Ketika Anda telah meninjau pengaturan Anda, pilih **Buat pipeline** untuk membuat pipeline Anda.
1. Anda dapat melihat pesan sukses atau gagal di bagian atas halaman, karena sumber daya Anda dibuat untuk pengaturan distribusi, konfigurasi infrastruktur, resep baru, dan pipeline. Untuk melihat detail sumber daya, termasuk pengenal sumber daya, pilih **Lihat detail**.
1. Setelah melihat detail sumber daya, Anda dapat melihat detail tentang sumber daya lain dengan memilih jenis sumber daya dari panel navigasi. Misalnya, untuk melihat detail pipeline baru Anda, pilih **Pipeline gambar** dari panel navigasi. Jika build berhasil, pipeline baru akan ditampilkan di daftar **pipeline Image**.
## Langkah 6: Bersihkan
Lingkungan Image Builder Anda, 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 lupa tentang sumber daya itu, dan kemudian, tidak ingat untuk apa sumber daya itu 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**
1. Untuk melihat daftar pipeline build yang dibuat di bawah akun Anda, pilih **Pipeline gambar** dari panel navigasi.
1. Pilih kotak centang di samping **nama Pipeline** untuk memilih pipeline yang ingin Anda hapus.
1. Di bagian atas panel **pipa gambar**, pada menu **Tindakan**, pilih **Hapus**.
1. **Untuk mengonfirmasi penghapusan, masukkan `Delete` di dalam kotak, dan pilih Hapus.**
**Hapus resep wadah**
1. Untuk melihat daftar resep kontainer yang dibuat di bawah akun Anda, pilih **Resep kontainer** dari panel navigasi.
1. Pilih kotak centang di sebelah **Nama resep** untuk memilih resep yang ingin Anda hapus.
1. Di bagian atas panel **Resep kontainer**, pada menu **Tindakan**, pilih **Hapus resep**.
1. **Untuk mengonfirmasi penghapusan, masukkan `Delete` di dalam kotak, dan pilih Hapus.**
**Hapus konfigurasi infrastruktur**
1. Untuk melihat daftar konfigurasi infrastruktur yang dibuat di bawah akun Anda, pilih **Konfigurasi infrastruktur** dari panel navigasi.
1. Pilih kotak centang di sebelah **Nama konfigurasi** untuk memilih konfigurasi infrastruktur yang ingin Anda hapus.
1. Di bagian atas panel **konfigurasi Infrastruktur**, pilih **Hapus**.
1. **Untuk mengonfirmasi penghapusan, masukkan `Delete` di dalam kotak, dan pilih Hapus.**
**Hapus pengaturan distribusi**
1. Untuk melihat daftar setelan distribusi yang dibuat di bawah akun Anda, pilih **Pengaturan distribusi** dari panel navigasi.
1. Pilih kotak centang di sebelah **Nama konfigurasi** untuk memilih pengaturan distribusi yang Anda buat untuk tutorial ini.
1. Di bagian atas panel **Pengaturan distribusi**, pilih **Hapus**.
1. **Untuk mengonfirmasi penghapusan, masukkan `Delete` di dalam kotak, dan pilih Hapus.**
**Hapus gambar**
Ikuti langkah-langkah ini untuk memverifikasi bahwa Anda telah menghapus gambar apa pun yang dibuat dari saluran tutorial. Tutorial ini tidak mungkin membuat gambar kecuali waktu yang cukup telah berlalu sejak Anda membuat pipeline yang berjalan, sesuai dengan jadwal pembuatan.
1. Untuk melihat daftar gambar yang dibuat di bawah akun Anda, pilih **Gambar** dari panel navigasi.
1. Pilih **Versi** gambar untuk gambar yang ingin Anda hapus. Ini membuka halaman **Image build version**.
1. Pilih kotak centang di sebelah **Versi** untuk gambar apa pun yang ingin Anda hapus. Anda dapat memilih lebih dari satu versi gambar sekaligus.
1. Di bagian atas panel **Image build version**, pilih **Delete version**.
1. **Untuk mengonfirmasi penghapusan, masukkan `Delete` di dalam kotak, dan pilih Hapus.**