Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu Cloud Scheduler

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

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

Misalnya, jika telah menyediakan integrasi di us-central1, Anda dapat menggunakan pemicu Cloud Scheduler untuk men-deploy tugas cron di asia-east1 (atau 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 tugas cron yang dibuat menggunakan pemicu Cloud Scheduler di Integrasi Aplikasi. Untuk mengetahui informasi selengkapnya tentang tagihan 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).

   Mengaktifkan Cloud Scheduler API

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

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

   Untuk mengetahui informasi tentang peran Integrasi Aplikasi bawaan, lihat Peran IAM bawaan.

Menambahkan pemicu Cloud Scheduler

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

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations

   Halaman Daftar Integrasi akan muncul yang 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: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk 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 Create.

   Tindakan ini akan membuka integrasi 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 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 tugas cron.
   • Lanjutan: Gunakan ekspresi unix-cron untuk mengonfigurasi jadwal tugas cron.
2. (Untuk opsi Dasar) Pilih tab Dasar dan lakukan hal 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. Days: Pilih hari saat integrasi harus berjalan. 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 Advanced dan tentukan jadwal tugas cron 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, salah satu dari 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 tugas cron.

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

Output pemicu

Untuk setiap pemicu Cloud Scheduler yang dikonfigurasi dan dipublikasikan dalam versi integrasi Anda, Integrasi Aplikasi 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 View di kolom Logs.

   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 menimpa tugas cron yang ada dengan tugas cron baru dalam versi integrasi baru.

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

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.
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 yang akan diedit.
3. Klik Edit.
4. Ubah konfigurasi tugas Cloud Scheduler sesuai keinginan.

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

Menjeda, Melanjutkan, Menyalin tugas Cloud Scheduler

Integrasi Aplikasi 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 tugas cron menggunakan Cloud Scheduler, lihat Menjeda atau melanjutkan tugas

Menghapus tugas Cloud Scheduler

Anda dapat menghapus tugas Cloud Scheduler dari dalam integrasi di Integrasi Aplikasi atau dari Cloud Scheduler.

Application Integration

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

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations. Halaman Integrations akan muncul.
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 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 Integrasi Aplikasi.
• Pemicu Cloud Scheduler di 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 diperlukan lagi. Jika Anda membiarkan pemicu Cloud Scheduler yang redundan dipublikasikan, pemicu tersebut akan terus memanggil integrasi secara otomatis, yang dapat menyebabkan tagihan penagihan tambahan.

Memecahkan masalah pemicu Cloud Scheduler

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

Lokasi error	Kejadian 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 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 diberikan 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

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) Integration Aplikasi hanya berlaku jika eksekusi berhasil dijadwalkan untuk integrasi active.