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.

Penting: Biaya terpisah akan berlaku untuk penggunaan layanan Cloud Scheduler dalam integrasi Anda. Anda akan dikenai biaya berdasarkan jumlah cron job yang dibuat menggunakan pemicu Cloud Scheduler di Application Integration. Untuk mengetahui informasi selengkapnya tentang biaya Cloud Scheduler, lihat harga Cloud Scheduler.

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.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk mengetahui informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   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.

Catatan: Application Integration tidak menyimpan atau mengumpulkan log apa pun yang dihasilkan oleh pemicu Cloud Scheduler. Log ini disimpan di project Google Cloud Anda dan hanya dapat dilihat dari halaman Logs Explorer Cloud Logging.

Mengedit pemicu Cloud Scheduler

Application Integration

Peringatan: Mengedit pemicu Cloud Scheduler dari Integrasi Aplikasi akan menggantikan cron job yang ada dengan cron job baru dalam versi integrasi baru.

Untuk mengedit pemicu Cloud Scheduler dari Application Integration, lakukan langkah-langkah berikut:

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

   Buka Application Integration

2. Klik Integrasi dari menu navigasi kiri untuk membuka halaman Integrasi.
3. Pilih integrasi yang ingin Anda edit.
4. Di integration editor, klik drop-down Versi, lalu pilih versi integrasi yang berisi pemicu Cloud Scheduler yang ingin Anda edit.
5. Batalkan publikasi dan aktifkan pengeditan Jika versi integrasi yang dipilih dipublikasikan (dalam status aktif).
6. Klik elemen Pemicu Cloud Scheduler di editor integrasi untuk membuka panel konfigurasi pemicu.
7. Ubah konfigurasi tugas Cloud Scheduler sesuai keinginan.

Cloud Scheduler

Anda dapat mengedit pemicu Cloud Scheduler dengan mengubah konfigurasi tugas Cloud Scheduler dari Cloud Scheduler:

1. Di konsol Google Cloud , buka Cloud Scheduler.

   Buka Cloud Scheduler

2. Pilih tugas Cloud Scheduler yang akan diedit.
3. Klik Edit.
4. Ubah konfigurasi tugas Cloud Scheduler sesuai keinginan.

Catatan: Mengedit tugas Cloud Scheduler dari Cloud Scheduler tidak mengubah status versi integrasi target.

Menjeda, Melanjutkan, Menyalin tugas Cloud Scheduler

Application Integration tidak mendukung operasi jeda, lanjutkan, dan salin untuk tugas Cloud Scheduler yang dibuat menggunakan pemicu Cloud Scheduler.

Pemicu Cloud Scheduler akan memunculkan error di panel konfigurasi pemicu jika Anda secara manual menjeda eksekusi tugas Cloud Scheduler dari Cloud Scheduler.

Untuk mengetahui informasi selengkapnya tentang pesan error pemicu Cloud Scheduler, lihat Memecahkan masalah pemicu Cloud Scheduler. Untuk mengetahui informasi tentang cara menjeda dan melanjutkan cron job menggunakan Cloud Scheduler, lihat Menjeda atau melanjutkan tugas

Menghapus tugas Cloud Scheduler

Anda dapat menghapus tugas Cloud Scheduler baik dari dalam integrasi di Application Integration maupun dari Cloud Scheduler.

Application Integration

Untuk menghapus tugas Cloud Scheduler dari Application Integration, lakukan langkah-langkah berikut:

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

   Buka Application Integration

2. Klik Integrasi dari menu navigasi kiri untuk membuka halaman Integrasi.
3. Pilih integrasi yang ingin Anda edit.
4. Di integration editor, klik dropdown Versi, lalu pilih versi integrasi yang berisi pemicu Cloud Scheduler yang ingin Anda hapus.
5. Batalkan publikasi versi integrasi yang dipilih.

   Tugas Cloud Scheduler untuk versi integrasi yang sesuai akan dihapus.

Cloud Scheduler

Untuk menghapus tugas Cloud Scheduler dari Cloud Scheduler, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka Cloud Scheduler.

   Buka Cloud Scheduler

2. Pilih tugas Cloud Scheduler yang akan dihapus.
3. Klik Hapus.

   Tugas Cloud Scheduler untuk versi integrasi yang sesuai akan dihapus.

Catatan:

• Menghapus tugas Cloud Scheduler dari Cloud Scheduler tidak akan menghapus pemicu Cloud Scheduler dalam integrasi Anda di Application Integration.
• Pemicu Cloud Scheduler dalam integrasi Anda akan menampilkan error di panel konfigurasi pemicu jika tugas Cloud Scheduler dihapus menggunakan Cloud Scheduler. Untuk mengetahui informasi selengkapnya tentang pesan error pemicu Cloud Scheduler, lihat Memecahkan masalah pemicu Cloud Scheduler.

Praktik terbaik

Sebagai praktik terbaik, batalkan publikasi pemicu Cloud Scheduler jika tidak lagi diperlukan. Jika Anda membiarkan pemicu Cloud Scheduler yang berlebihan dipublikasikan, pemicu akan terus memanggil integrasi secara otomatis, yang dapat menyebabkan biaya penagihan tambahan.

Memecahkan masalah pemicu Cloud Scheduler

Tabel berikut menjelaskan error yang mungkin Anda alami di pemicu Cloud Scheduler, dan penyebab yang sesuai untuk error tersebut.

Lokasi error	Terjadinya error	Pesan error	Kemungkinan penyebab	Resolusi
Panel konfigurasi pemicu > Pesan Error	Saat tugas Cloud Scheduler menghentikan eksekusi integrasi Anda	The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB does not exist. It might be deleted from your Google Cloud project.	Tugas Cloud Scheduler dihapus menggunakan Cloud Scheduler.	Buat versi integrasi baru untuk menggantikan tugas Cloud Scheduler yang ada.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.	Tugas Cloud Scheduler dijeda menggunakan Cloud Scheduler.	Lanjutkan tugas Cloud Scheduler dari Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.	Periksa Log pemicu untuk mengidentifikasi masalah.	Buat versi integrasi baru untuk menggantikan tugas Cloud Scheduler yang ada.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.	Akun layanan yang diberikan tidak memiliki izin IAM yang diperlukan.	Untuk memulihkan tugas dari status ini, coba lagi operasi CloudScheduler.UpdateJob hingga respons berhasil diterima.
		The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.	CLOUD_SCHEDULER_JOB_ISSUE	NA

Pengecualian SLA

Pemicu Cloud Scheduler bergantung pada produk Cloud Scheduler. Karena dependensi ini bersifat eksternal terhadap Integrasi Aplikasi, persyaratan dan ketentuan Perjanjian Tingkat Layanan (SLA) Integrasi Aplikasi hanya berlaku jika eksekusi berhasil dijadwalkan untuk integrasi active.