Menjadwalkan build

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

Sebelum memulai

  • Aktifkan Cloud Build API.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

    Mengaktifkan API

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

Menjadwalkan build

Setelah membuat pemicu manual, Anda siap menjadwalkan build.

Untuk menjadwalkan build:

  1. Buka halaman Pemicu:

    Buka halaman Pemicu

  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 Jalankan sesuai jadwal untuk menjadwalkan build Anda.

    Anda akan melihat panel Jalankan pemicu sesuai jadwal di sisi kanan.

  5. Aktifkan Cloud Scheduler API.

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

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

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

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com

    Jika Anda memilih akun layanan penjadwalan default, akun tersebut akan otomatis dibuat untuk Anda dengan peran IAM Editor Cloud Build 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 Editor Cloud Build. Anda mungkin harus menunggu hingga satu jam agar tugas Cloud Scheduler yang ada dapat dilanjutkan setelah membuat ulang akun layanan.

    Jika pemicu manual Anda menggunakan a 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 Anda 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 nanti. Untuk mempelajari lebih lanjut, lihat Region yang didukung.

  8. Masukkan setelan tugas Cloud Scheduler berikut:

    • Nama: Nama untuk tugas Cloud Scheduler Anda.
    • Deskripsi (Opsional): Deskripsi untuk tugas Cloud Scheduler Anda.
    • Frekuensi: Pilih frekuensi yang Anda inginkan untuk menjalankan pemicu. Anda dapat memilih frekuensi dari menu drop-down atau memasukkan nilai kustom menggunakan sintaksis cron. Misalnya, jika Anda ingin pemicu manual berjalan setiap hari 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 Buat untuk membuat tugas Cloud Scheduler Anda.

    Anda dapat membuat beberapa tugas penjadwal untuk setiap pemicu manual.

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

Memperbarui tugas Cloud Scheduler

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

Untuk memperbarui tugas Cloud Scheduler:

  1. Buka halaman Cloud Scheduler:

    Buka halaman Cloud Scheduler

    Anda akan melihat daftar tugas Cloud Scheduler.

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

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

      gcloud builds triggers describe TRIGGER_NAME

    2. Catat ID pemicu Anda.

    3. Masukkan ID pemicu Anda ke 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 Perbarui.

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

Menghapus tugas Cloud Scheduler

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

Untuk memastikan pemicu Anda tidak lagi berjalan pada waktu tertentu, hapus tugas Cloud Scheduler.

Langkah berikutnya