Pemicu Cloud Scheduler

Pemicu Cloud Scheduler memungkinkan Anda menjadwalkan eksekusi integrasi untuk jangka waktu tertentu atau interval reguler di beberapa region.

Pemicu Cloud Scheduler memanfaatkan layanan Cloud Scheduler untuk menyediakan penjadwal cron job tingkat perusahaan yang terkelola sepenuhnya dalam Integrasi Aplikasi. Dengan pemicu ini, Anda kini dapat mengelola semua cron job yang dibuat dalam integrasi, baik dari UI Application Integration, maupun dasbor Cloud Scheduler. Selain itu, pemicu Cloud Scheduler juga memungkinkan Anda men-deploy tugas cron lintas region untuk menjadwalkan eksekusi integrasi.

Misalnya, jika Anda telah menyediakan integrasi di us-central1, Anda dapat menggunakan pemicu Cloud Scheduler untuk men-deploy cron job di asia-east1 (atau salah satu region Google Cloud yang didukung untuk Cloud Scheduler) guna memanggil endpoint integrasi Anda di us-central1.

Sebelum memulai

Pastikan Anda melakukan tugas berikut di project Google Cloud sebelum mengonfigurasi pemicu Cloud Scheduler:

1. Aktifkan Cloud Scheduler API (cloudscheduler.googleapis.com).

   Aktifkan Cloud Scheduler API

2. Pastikan Anda memiliki akun layanan Google dengan peran Application Integration Invoker yang ditetapkan. Jika Anda tidak memiliki akun layanan, Anda harus membuat akun layanan baru, dan menetapkan peran Pemanggil Integrasi Aplikasi ke akun tersebut.

   Untuk mengetahui informasi tentang cara membuat dan mengelola akun layanan, lihat Membuat dan mengelola akun layanan

   Untuk mengetahui informasi tentang peran bawaan Application Integration, lihat Peran IAM bawaan.

Tambahkan pemicu Cloud Scheduler

Untuk menambahkan pemicu Cloud Scheduler ke integrasi Anda, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Buat Integrasi.
   2. Pilih region untuk integrasi.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel info Ringkasan integrasi di toolbar integrasi.
   4. Klik Buat.

   Integrasi yang baru dibuat akan terbuka di editor integrasi.

4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen pemicu Cloud Scheduler di editor integrasi.

Mengonfigurasi pemicu Cloud Scheduler

Untuk mengonfigurasi pemicu Cloud Scheduler, lakukan langkah-langkah berikut:

1. Klik elemen Pemicu Cloud Scheduler di editor integrasi untuk membuka panel konfigurasi pemicu.

   Tentukan jadwal pemicu Cloud Scheduler menggunakan salah satu opsi berikut:

   • Dasar: Gunakan antarmuka pengguna untuk mengonfigurasi jadwal tugas cron.
   • Lanjutan: Gunakan ekspresi unix-cron untuk mengonfigurasi jadwal cron job.
2. (Untuk opsi Dasar) Pilih tab Dasar dan lakukan langkah-langkah berikut di kolom yang ditunjukkan:
   1. Waktu: Pilih interval waktu saat integrasi harus berjalan.
      • Jalankan pada waktu tertentu: Pilih opsi ini untuk menjalankan integrasi pada waktu tertentu.
      • Ulangi per jam: Pilih opsi ini untuk menjalankan integrasi berulang kali setiap jam.
      • Ulangi per menit: Pilih opsi ini untuk menjalankan integrasi berulang kali sesuai dengan jumlah menit yang ditentukan
   2. Hari: Pilih hari saat integrasi harus dijalankan. Anda dapat memilih untuk menjalankan integrasi setiap hari, atau pada hari tertentu dalam seminggu, atau pada hari tertentu dalam sebulan.
   3. Bulan: Pilih bulan saat integrasi harus berjalan. Anda dapat memilih untuk menjalankan integrasi setiap bulan, atau selama bulan tertentu.
3. (Untuk opsi Lanjutan) Pilih tab Lanjutan dan tentukan jadwal cron job menggunakan ekspresi cron.

   Ekspresi cron memiliki lima nilai yang harus ditentukan dalam urutan berikut:

   1. Menit (0-59)
   2. Jam (0-23)
   3. Hari dalam sebulan (1-31)
   4. Bulan, salah satu nilai berikut:
      • Angka 1-12
      • Singkatan bulan tiga huruf (Misalnya, Jan, Feb, Mar)
   5. Hari dalam seminggu, salah satu nilai berikut:
      • Angka dari 0 - 6 yang dimulai dengan Minggu sebagai 0
      • Singkatan hari tiga huruf (Misalnya, Sen, Sel, Rab)

   Misalnya, untuk menjalankan integrasi pada hari pertama setiap bulan, gunakan ekspresi cron * * 1 * *.

   Untuk informasi selengkapnya, lihat Mengonfigurasi jadwal cron job.

4. Region: Pilih region tempat tugas Cloud Scheduler Anda akan di-deploy.
5. Email akun layanan: Masukkan alamat email akun layanan Google yang dibuat.

Output pemicu

Untuk setiap pemicu Cloud Scheduler yang dikonfigurasi dan dipublikasikan di versi integrasi Anda, Application Integration akan membuat tugas Cloud Scheduler baru di project Google Cloud Anda.

Tugas Cloud Scheduler dibuat menggunakan konvensi penamaan berikut untuk menghindari error duplikasi tugas:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

Contoh: DemoIntegration__V1__1

Log pemicu

Pemicu Cloud Scheduler menghasilkan log di awal dan akhir setiap eksekusi integrasi. Anda dapat melihat log pemicu Cloud Scheduler di halaman Cloud Logging Logs Explorer:

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

   Buka Cloud Scheduler

2. Temukan tugas Cloud Scheduler Anda, lalu klik Lihat di kolom Log.

   Halaman Cloud Logging Logs Explorer akan muncul dan menampilkan log yang dihasilkan oleh pemicu Cloud Scheduler.

Mengedit pemicu Cloud Scheduler