Pemicu Cloud Scheduler

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Integrasi Apigee dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Pemicu Cloud Scheduler dapat Anda gunakan untuk menjadwalkan eksekusi integrasi untuk jangka waktu yang ditentukan 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 Apigee. Dengan menggunakan pemicu ini, Anda kini dapat mengelola semua cron job yang dibuat dalam integrasi, baik dari UI Integrasi Apigee maupun dasbor Cloud Scheduler. Selain itu, pemicu Cloud Scheduler juga memungkinkan Anda men-deploy cron job lintas region untuk menjadwalkan eksekusi integrasi Anda.

Misalnya, jika telah menyediakan integrasi di us-central1, Anda dapat menggunakan pemicu Cloud Scheduler untuk men-deploy cron job di asia-east1 (atau region Google Cloud apa pun yang didukung untuk Cloud Scheduler) untuk 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 Integrasi Apigee. 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 Apigee Integration Invoker yang ditetapkan. Jika belum memiliki akun layanan, Anda harus membuat akun baru, dan menetapkan peran Apigee Integration Invoker ke akun tersebut.

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

   Untuk mengetahui informasi tentang peran Integrasi Apigee standar, lihat Peran IAM yang telah ditetapkan.

Menambahkan pemicu Cloud Scheduler

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

1. Di UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di desainer integrasi.

4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Pemicu untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen Cloud Scheduler trigger di editor integrasi.

Mengonfigurasi pemicu Cloud Scheduler

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

1. Klik elemen Cloud Scheduler trigger 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 cron job.
   • Lanjutan: Gunakan ekspresi unix-cron untuk mengonfigurasi jadwal cron job.
2. (Untuk opsi Dasar) Pilih tab Dasar dan lakukan hal berikut di kolom yang ditunjukkan:
   1. Waktu: Pilih interval waktu saat integrasi harus dijalankan.
      • Menjalankan pada waktu tertentu: Pilih opsi ini untuk menjalankan integrasi pada waktu tertentu.
      • Ulangi menurut jam: Pilih opsi ini untuk berulang kali menjalankan integrasi setiap jam.
      • Ulangi menurut menit: Pilih opsi ini untuk berulang kali menjalankan integrasi sesuai 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 untuk menjalankan integrasi. Anda dapat memilih untuk menjalankan integrasi setiap bulan, atau selama bulan tertentu.
3. (Untuk opsi Lanjutan) Pilih tab Advanced lalu 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 (31-1)
   4. Bulan, dengan salah satu nilai berikut:
      • Angka 1-12
      • Singkatan bulan yang terdiri dari tiga huruf (Misalnya, Jan, Feb, Mar)
   5. Hari, salah satu nilai berikut:
      • Angka dari 0 - 6 yang dimulai dengan hari Minggu sebagai 0
      • Singkatan tiga huruf hari (Misalnya, Sen, Sel, Rab)

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

   Untuk mengetahui 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 dalam versi integrasi Anda, Apigee Integration 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 dan klik View di kolom Logs.

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

Catatan: Integrasi Apigee 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 Cloud Logging Logs Explorer.

Mengedit pemicu Cloud Scheduler

Apigee Integration

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

Untuk mengedit pemicu Cloud Scheduler dari Integrasi Apigee, lakukan langkah-langkah berikut:

1. Di UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Pilih integrasi yang ingin Anda edit.
4. Di editor integrasi, klik dropdown 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 Cloud Scheduler trigger 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 untuk 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, Lanjutkan, Menyalin tugas Cloud Scheduler

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

Pemicu Cloud Scheduler menampilkan error di panel konfigurasi pemicu jika Anda menjeda eksekusi tugas Cloud Scheduler secara manual 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 dari dalam integrasi di Integrasi Apigee atau dari Cloud Scheduler.

Apigee Integration

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

1. Di UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Pilih integrasi yang ingin Anda edit.
4. Di editor integrasi, klik dropdown Versi, lalu pilih versi integrasi yang berisi pemicu Cloud Scheduler yang ingin dihapus.
5. Batalkan publikasi versi integrasi yang dipilih.

   Tugas Cloud Scheduler untuk versi integrasi yang terkait 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 Delete.

   Tugas Cloud Scheduler untuk versi integrasi yang terkait akan dihapus.

Catatan:

• Menghapus tugas Cloud Scheduler dari Cloud Scheduler tidak akan menghapus pemicu Cloud Scheduler dalam integrasi Anda di Integrasi Apigee.
• Pemicu Cloud Scheduler dalam integrasi Anda 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 diperlukan lagi. Jika Anda memublikasikan pemicu Cloud Scheduler yang redundan, 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 temui dalam pemicu Cloud Scheduler, dan penyebab error yang berkaitan.

Lokasi error	Kemunculan 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 doesn’t exist. It might be deleted from your Google Cloud project.	Tugas Cloud Scheduler akan dihapus menggunakan Cloud Scheduler.	Buat versi integrasi baru untuk menimpa 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 menimpa 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 disediakan tidak memiliki izin IAM yang diperlukan.	Untuk memulihkan tugas dari status ini, coba lagi operasi CloudScheduler.UpdateJob hingga respons yang 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