Membuat dan mengelola pipeline image OS kustom menggunakan konsol Google Cloud

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "apa adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengetahui informasi tentang akses ke rilis ini, lihat halaman permintaan akses.

Konfigurasi dan luncurkan pipeline Image Builder langsung di Google Cloud konsol. Konsol Google Cloud menyediakan antarmuka interaktif tempat Anda dapat menentukan sumber image dasar, tujuan output, langkah penyesuaian, dan pemicu eksekusi.

Sebelum memulai

• Selesaikan langkah-langkah penyiapan lingkungan di Menyiapkan lingkungan Anda.
• Jika Anda ingin memicu build secara otomatis dari repositori Git, hubungkan repositori GitHub, GitLab, atau Bitbucket Anda menggunakan repositori Cloud Build (2nd gen) atau link koneksi Developer Connect.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola pipeline penyesuaian image menggunakan Google Cloud konsol, minta administrator untuk memberi Anda peran IAM berikut pada project Anda:

• Editor Cloud Build (roles/cloudbuild.builds.editor)
• Pengguna Akun Layanan (roles/iam.serviceAccountUser)
• Admin Compute (roles/compute.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat dan mengelola pipeline

Di Google Cloud konsol, Anda dapat membuat pipeline image OS kustom baru, mengedit konfigurasi yang ada, menduplikasi pipeline yang ada, atau menghapus pipeline jika tidak lagi diperlukan.

Membuat pipeline

Untuk membuat pipeline image OS kustom menggunakan Google Cloud konsol, selesaikan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Images.

   Buka Images

2. Klik Image Builder untuk membuka halaman beranda Image Builder.

3. Di pemilih region, pilih region tempat Anda ingin membuat pipeline.

4. Klik Create a pipeline.

5. Di bagian Pipeline settings, konfigurasi detail pipeline inti:

   • Name: Masukkan nama unik untuk pipeline.
   • Description: (Opsional) Masukkan deskripsi untuk pipeline.
   • Region: Pilih Google Cloud region untuk pipeline Anda. Image Builder didukung di setiap region tempat Cloud Build tersedia.
   • Akun layanan: Pilih akun layanan yang dikonfigurasi dengan izin IAM yang diperlukan, atau buat akun layanan baru.
   • Configuration source: Pilih salah satu metode berikut untuk tempat konfigurasi dan skrip penyesuaian Anda disimpan:
     • Integrate with a repository: Pilih opsi ini untuk mengambil resep dan skrip penyesuaian Anda dari repositori Git. Karena file imagebuilder.yaml repositori menentukan image dasar sumber, zona build, langkah penyesuaian, dan setelan image target, konsol akan langsung melanjutkan ke pemicu. Konfigurasikan kolom berikut:
       • Repository: Pilih repositori yang terhubung, atau klik Link repository untuk menghubungkan repositori GitHub, GitLab, atau Bitbucket.
       • Path to image builder configuration: Masukkan jalur relatif ke file resep penyesuaian Anda di dalam repositori, seperti imagebuilder.yaml.
       • Cloud Storage folder: Klik Browse untuk memilih folder Cloud Storage tempat log pipeline dan artefak build diupload.
     • Store scripts in Google Cloud Storage: Pilih alternatif ini untuk mengonfigurasi image dasar, detail image target, dan langkah penyesuaian langsung di antarmuka konsol. Konsol akan menyimpan skrip Anda ke Cloud Storage dan memandu Anda melalui wizard langkah demi langkah lengkap. Konfigurasikan kolom berikut:
       • Customization script folder: Klik Browse untuk memilih folder Cloud Storage tempat menyimpan skrip penyesuaian Anda.
   • Artifact Registry: (Opsional) Jika Anda ingin mengupload arsip image target dan membuat pengesahan provenance build SLSA kriptografi, pilih repositori generik dari daftar Artifact Registry repository. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi asal image.

6. Klik Next untuk melanjutkan ke panel konfigurasi yang tersisa berdasarkan sumber konfigurasi yang Anda pilih:

   • Jika Anda memilih Integrate with a repository:

     Resep imagebuilder.yaml repositori menentukan image dasar sumber, setelan image target, dan langkah penyesuaian Anda. Konsol akan melewati entri manual dan langsung melanjutkan ke pemicu:

     1. Di bagian Triggers, konfigurasi kapan pipeline Anda berjalan:
        • Run on schedule: Tentukan jadwal berulang menggunakan sintaksis cron.
        • Run on repository event: Pemicu build otomatis saat peristiwa repositori terjadi, seperti Push to a branch, Push new tag, atau permintaan pull, dan tentukan pola filter cabang atau tag.
     2. Klik Next untuk melanjutkan ke bagian Summary.
     3. Tinjau konfigurasi pipeline Anda, lalu klik Create.

   • Jika Anda memilih Store scripts in Google Cloud Storage:

     1. Di bagian Source image details, tentukan image OS dasar:
        • Use an image family: Pilih keluarga OS publik, seperti Container-Optimized OS atau Ubuntu. Pipeline akan otomatis memilih image non-deprecated terbaru dalam keluarga tersebut untuk setiap build.
        • Use an existing image: Pilih image OS tertentu.
     2. Klik Next untuk melanjutkan ke bagian Target image details :
        • Masukkan nama untuk image OS kustom yang dibuat.
        • (Opsional) Tentukan keluarga image, deskripsi, label resource, dan kunci enkripsi yang dikelola pelanggan (CMEK).
     3. Klik Next untuk melanjutkan ke bagian Customization :
        • Pilih Customization actions untuk menambahkan, mengedit, atau mengurutkan ulang langkah penyesuaian terpisah, seperti menginstal paket atau menjalankan skrip shell inline.
        • Pilih Add YAML untuk menulis atau menempel resep mentah steps langsung dalam YAML.
        • (Opsional) Di bagian Advanced configurations, pilih Zone, Machine type, atau Reservation tertentu yang akan digunakan untuk VM pekerja dan pengujian tempat tugas build berjalan. Jenis mesin bare metal tidak didukung.
     4. Klik Next untuk melanjutkan ke bagian Triggers :
        • Pilih Run on schedule untuk menentukan jadwal berulang otomatis, atau biarkan tidak dicentang untuk eksekusi manual.
     5. Klik Next untuk melanjutkan ke bagian Summary.
     6. Tinjau konfigurasi pipeline Anda, lalu klik Create.

Setelah Anda membuat pipeline:

• Jika Anda tidak mengonfigurasi pemicu otomatis, Anda dapat menjalankan pipeline secara manual: dari daftar pipeline Image Builder, klik More actions > Run di samping pipeline Anda.
• Jika Anda mengonfigurasi Run on schedule atau Run on repository event, pipeline akan berjalan secara otomatis saat kondisi pemicu atau jadwal terpenuhi.

Mengedit pipeline

Untuk mengedit pipeline Image Builder yang ada, selesaikan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Images.

   Buka Images

2. Klik Image Builder untuk melihat daftar pipeline Anda.

3. Di samping pipeline yang ingin Anda edit, klik More actions > Edit.

4. Perbarui setelan pipeline, sumber konfigurasi, detail image target, langkah penyesuaian, atau setelan pemicu sesuai kebutuhan.

   Catatan: Pipeline name dan Region tidak dapat diubah setelah pembuatan dan dikunci di konsol. Untuk mengubah setelan ini, Anda harus membuat pipeline baru.

5. Klik Save.

Menduplikasi pipeline

Untuk membuat pipeline baru dengan menyalin konfigurasi yang ada, selesaikan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Images.

   Buka Images

2. Klik Image Builder untuk melihat daftar pipeline Anda.

3. Di samping pipeline yang ingin Anda duplikat, klik More actions > Duplicate.

4. Di formulir pembuatan pipeline, tinjau parameter yang telah diisi sebelumnya dan disalin dari pipeline asli. Anda dapat mengedit kolom Pipeline name untuk menentukan nama unik baru.

5. Perbarui parameter atau setelan pipeline sesuai kebutuhan.

6. Klik Create.

Menghapus pipeline

Saat Anda menghapus pipeline, Image Builder akan menghentikan operasi otomatis di masa mendatang dan menghapus konfigurasi pipeline secara permanen. Menghapus pipeline tidak akan menghapus image OS kustom, artefak Artifact Registry, atau bucket Cloud Storage yang Anda buat sebelumnya.

Untuk menghapus pipeline Image Builder, selesaikan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Images.

   Buka Images

2. Klik Image Builder untuk melihat daftar pipeline Anda.

3. Di samping pipeline yang ingin Anda hapus, klik More actions > Delete.

4. Di dialog konfirmasi, klik Delete untuk menghapus pipeline secara permanen.

Memverifikasi dan memantau build

Untuk melacak progres pipeline build Anda, selesaikan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Cloud Build.

   Buka Cloud Build

2. Di menu navigasi, klik History untuk melihat tugas aktif atau selesai.

3. Di daftar Builds, klik Build ID build Anda untuk memeriksa log operasi container. Log menampilkan langkah-langkah yang dilakukan di dalam VM pekerja seperti update paket sistem atau perintah shell kustom, diikuti dengan hasil pengujian validasi dari VM pengujian, dan pendaftaran output akhir.

Langkah berikutnya

• Pelajari cara menentukan resep penyesuaian di Skema resep penyesuaian.
• Jika Anda ingin mengonfigurasi dan menjalankan pipeline secara terprogram menggunakan file konfigurasi, lihat Membuat pipeline image OS kustom menggunakan gcloud CLI atau Terraform.
• Verifikasi asal image.