Menjadwalkan build

Halaman ini menjelaskan cara menjalankan build sesuai jadwal yang telah ditentukan menggunakan konsolGoogle Cloud . Untuk menjadwalkan build, Anda harus membuat pemicu manual, lalu memanggil pemicu tersebut menggunakan Cloud Scheduler.

Sebelum memulai

  • Aktifkan Cloud Build API, jika belum diaktifkan.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

    Mengaktifkan API

  • Siapkan kode sumber Anda.
  • Jika Anda belum melakukannya, buat pemicu manual. Anda hanya dapat menjadwalkan build jika pemicu Anda adalah pemicu manual.
  • Jika Anda berencana menggunakan akun layanan yang ditentukan pengguna untuk pemicu build, pastikan Anda telah menyiapkan alamat email akun layanan tersebut. Anda harus memberikan izin kepada akun layanan penjadwalan untuk menggunakannya.

Menjadwalkan build

Setelah membuat pemicu manual, Anda siap menjadwalkan build.

Untuk menjadwalkan build:

  1. Buka halaman Triggers:

    Buka halaman Triggers

  2. Temukan baris yang berisi nama pemicu manual yang ingin Anda jalankan sesuai jadwal.

  3. Klik menu Tindakan yang terletak di ujung kanan baris yang berisi pemicu Anda.

  4. Klik Run on schedule untuk menjadwalkan build Anda.

    Anda akan melihat panel Run trigger on schedule di sisi kanan.

  5. Aktifkan Cloud Scheduler API.

    Anda hanya akan diminta untuk mengaktifkan API Cloud Scheduler saat pertama kali menjadwalkan build.

  6. Pilih akun layanan yang ingin digunakan Cloud Scheduler saat memanggil pemicu Anda.

    Sebaiknya pilih akun layanan penjadwalan default, yang memiliki format berikut dengan PROJECT_ID sebagai project ID untuk project Anda:

     cloud-build-trigger-scheduler@PROJECT_ID.

    Saat Anda memilih akun layanan penjadwalan default, akun tersebut akan otomatis dibuat untuk Anda dengan peran IAM Cloud Build Editor yang diberikan.

    Sebaiknya jangan hapus akun layanan ini karena digunakan oleh Cloud Scheduler untuk menjadwalkan build. Jika Anda tidak sengaja menghapus akun layanan ini, atau mencabut izin IAM-nya, Anda dapat membuka halaman IAM untuk menambahkan akun layanan secara manual dan memberinya peran Cloud Build Editor. Anda mungkin perlu menunggu hingga satu jam agar tugas Cloud Scheduler yang ada dapat dilanjutkan setelah membuat ulang akun layanan.

    Jika pemicu manual Anda menggunakan akun layanan yang ditentukan pengguna, Anda juga harus memberikan peran Pengguna Akun Layanan (roles/iam.serviceAccountUser) ke akun layanan penjadwalan default di akun layanan yang ditentukan pengguna. Tanpa peran ini, Cloud Scheduler tidak akan memiliki izin untuk menjalankan pemicu.

  7. Klik Lanjutkan.

    Jika belum memilih region, Anda mungkin akan diminta untuk memilih region untuk tugas Cloud Scheduler sebelum melanjutkan ke langkah berikutnya. Saat Anda memilih region, aplikasi App Engine akan otomatis dibuat di project Anda. Anda tidak dapat mengubah region untuk project Anda di lain waktu. Untuk mempelajari lebih lanjut, lihat Wilayah yang didukung.

  8. Masukkan setelan tugas Cloud Scheduler berikut:

    • Name: Nama untuk tugas Cloud Scheduler Anda.
    • Description (Opsional): Deskripsi untuk tugas Cloud Scheduler Anda.
    • Frekuensi: Pilih seberapa sering Anda ingin pemicu dijalankan. Anda dapat memilih frekuensi dari menu drop-down atau memasukkan nilai kustom menggunakan sintaksis cron. Misalnya, jika Anda ingin pemicu manual berjalan setiap hari pada pukul 06.00, Anda dapat menentukan frekuensi dalam sintaksis cron sebagai 0 6 * * *. Untuk mempelajari sintaksis cron lebih lanjut, lihat Mengonfigurasi jadwal cron job.
    • Zona Waktu: Pilih zona waktu Anda.

  9. Klik Create untuk membuat tugas Cloud Scheduler.

    Anda dapat membuat beberapa tugas penjadwal untuk setiap pemicu manual.

  10. Jika Anda ingin melihat tugas Cloud Scheduler, klik View. Jika tidak, klik Selesai untuk menutup panel.

Memperbarui tugas Cloud Scheduler

Jika Anda memperbarui kolom Revision di pemicu manual, Anda harus memperbarui tugas Cloud Scheduler yang terkait dengan pemicu secara manual. Misalnya, jika Anda memperbarui nama cabang untuk pemicu manual, Anda harus memperbarui nama cabang dalam tugas secara manual.

Untuk memperbarui tugas Cloud Scheduler:

  1. Buka halaman Cloud Scheduler:

    Buka halaman Cloud Scheduler

    Anda akan melihat daftar tugas Cloud Scheduler Anda.

  2. [Opsional] Identifikasi tugas Cloud Scheduler yang terkait dengan pemicu Anda:

    1. Dapatkan ID pemicu Anda dengan menjalankan perintah berikut, dengan TRIGGER_NAME adalah nama pemicu Anda:

      gcloud builds triggers describe TRIGGER_NAME

    2. Catat ID pemicu Anda.

    3. Masukkan ID pemicu ke dalam panel filter di bagian atas tabel.

    Anda akan melihat daftar tugas Cloud Scheduler yang terkait dengan pemicu Anda.

  3. Klik baris yang berisi nama tugas yang ingin Anda perbarui.

  4. Klik Edit di bagian atas halaman.

    Anda akan melihat formulir untuk memperbarui tugas Cloud Scheduler.

  5. Di kolom Isi, perbarui revisi Anda.

  6. Klik Update.

Anda kini telah memperbarui revisi yang terkait dengan pemicu untuk tugas Cloud Scheduler.

Menghapus tugas Cloud Scheduler

Menghapus atau menonaktifkan pemicu tidak akan otomatis menghapus atau menonaktifkan semua tugas Cloud Scheduler yang dibuat secara otomatis saat Anda menjadwalkan pemicu. Tugas Anda akan tetap ada dan build mungkin akan terus dipanggil.

Untuk memastikan pemicu Anda tidak akan berjalan lagi pada waktu yang ditentukan, hapus tugas Cloud Scheduler Anda.

Langkah berikutnya