Lihat konektor yang didukung untuk Application Integration.

Pemicu Cloud Pub/Sub

Pemicu Cloud Pub/Sub memungkinkan Anda menjalankan integrasi berdasarkan peristiwa di middleware Pub/Sub Anda.

Dengan pemicu ini, Anda dapat menjalankan integrasi setiap kali penayang menulis pesan ke topik yang Anda pilih. Topik dapat berada di project Google Cloud yang sama dengan integrasi, atau di project Google Cloud yang berbeda. Saat dieksekusi, pemicu ini juga akan menulis pesan yang dipublikasikan ke variabel output CloudPubSubMessage. Berdasarkan persyaratan, Anda dapat menggunakan variabel ini dalam tugas atau pemicu downstream.

Sebelum memulai

Pastikan Anda melakukan tugas berikut di project Google Cloud sebelum mengonfigurasi pemicu Cloud Pub/Sub.

• Tetapkan Project IAM Admin (roles/resourcemanager.projectIamAdmin) kepada pengguna yang membuat pemicu ini.
• Aktifkan Pub/Sub API untuk project Google Cloud yang memiliki integrasi Anda.
• Pastikan Anda memiliki topik Pub/Sub. Untuk membuat topik Pub/Sub baru:
  1. Buka halaman topik Pub/Sub di Cloud Console.

     Buka halaman topik Pub/Sub

  2. Klik Buat topik.
  3. Di kolom ID Topik, berikan nama topik yang unik.
  4. Klik Save.
  Catatan: Anda tidak perlu membuat langganan agar pemicu dapat berfungsi. Application Integration secara otomatis membuat langganan untuk suatu topik, dan Anda dapat melihat semua langganan Anda di halaman langganan Pub/Sub.

  Mulai dari Application Integration rilis 1 Desember 2023, Anda akan ditagih untuk langganan Anda sesuai dengan tarif penagihan Pub/Sub. Langganan untuk pemicu Cloud Pub/Sub Anda yang ada akan terus berfungsi seperti sebelumnya, dan langganan tersebut tidak ditagih. Namun, jika Anda memperbarui topik pemicu Cloud Pub/Sub yang ada, penagihan Pub/Sub akan diterapkan ke pemicu Cloud Pub/Sub yang diperbarui.

Untuk mengetahui informasi selengkapnya tentang mengelola akses menggunakan peran IAM, lihat Kontrol akses.

Untuk mengetahui informasi tentang cara memberikan peran kepada akun utama, lihat Memberikan, mengubah, dan mencabut akses.

Menambahkan pemicu Cloud Pub/Sub

Untuk menambahkan pemicu Cloud Pub/Sub ke integrasi baru atau yang sudah ada, ikuti langkah-langkah di bawah:

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

   Buka Application Integration

2. Di menu navigasi, klik Integrasi

   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 Create Integration.
   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 wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary 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 Pub/Sub ke desainer.

Mengonfigurasi pemicu Cloud Pub/Sub

Klik elemen Cloud Pub/Sub trigger di editor integrasi untuk melihat panel konfigurasi pemicu, lalu lakukan tugas berikut:

1. Tentukan topik yang harus didengarkan oleh pemicu di kolom Pub/Sub topic dalam format berikut:

   projects/PROJECT_ID/topics/TOPIC_ID

   Untuk melihat semua topik yang tersedia di project Google Cloud Anda, lihat kolom Nama topik di Topik.

   Ganti kode berikut:
   • PROJECT_ID: project Google Cloud tempat topik Anda dibuat.
   • TOPIC_ID: ID topik Pub/Sub Anda. Topik dapat berada di project Google Cloud yang sama dengan integrasi Anda, atau dapat berada di project Google Cloud yang berbeda.
2. Pilih akun layanan yang ingin Anda gunakan untuk pemicu. Saat memilih akun layanan, Anda akan diminta untuk memberikan peran yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Peran IAM yang diperlukan.

   Jika tidak ada akun layanan, buat akun layanan dengan mengklik Create new di drop-down Service account.

   Catatan: Mulai dengan Application Integration rilis 1 Desember 2023, saat mengonfigurasi pemicu Cloud Pub/Sub, Anda harus menentukan akun layanan untuk pemicu tersebut. Pemicu Pub/Sub Anda yang ada, yang tidak memiliki akun layanan yang terkait dengannya, akan terus berfungsi seperti sebelumnya. Namun, jika ingin mengubah pemicu Pub/Sub yang ada, Anda harus mengonfigurasi akun layanan untuk terus menggunakan pemicu tersebut.

Peran IAM yang diperlukan untuk akun layanan

Mengklik Berikan saat memilih akun layanan, akan otomatis memberikan peran berikut ke berbagai akun layanan.

Akun layanan	Peran IAM diberikan
Akun layanan default Application Integration: [e-mail]	Editor Pub/Sub (roles/pubsub.editor) (roles/iam.serviceAccountUser) Pengguna Akun Layanan Jika project Google Cloud topik Pub/Sub berbeda dengan project Google Cloud integrasi, akun layanan default memerlukan peran Pub/Sub Editor dalam project Google Cloud topik.
Akun layanan yang Anda pilih untuk pemicu ini	Invoker Integrasi Aplikasi (roles/integrations.integrationInvoker)

Output Pemicu

Untuk setiap peristiwa, pemicu Cloud Pub/Sub menghasilkan variabel output CloudPubSubMessage yang dapat Anda gunakan dalam tugas downstream. Variabel ini dalam format JSON dan memiliki struktur PubsubMessage.

Pertimbangan

• Ukuran maksimum pesan Pub/Sub adalah 10 MB. Untuk memahami semua batasan Pub/Sub, lihat Kuota dan batas Pub/Sub.
• Ada kemungkinan bahwa Pub/Sub menulis pesan yang sama lebih dari sekali ke sebuah topik. Untuk memahami perilaku Pub/Sub ini, lihat pengiriman Minimal Sekali. Oleh karena itu, integrasi harus dirancang agar bersifat idempoten sehingga pesan tidak ditulis lebih dari sekali ke sebuah topik.
  Catatan: Kolom message_id dalam header pesan secara unik mengidentifikasi pesan Pub/Sub.
• Jika Anda membatalkan publikasi integrasi, langganan Pub/Sub tidak akan dihapus untuk mencegah hilangnya pesan. Namun, jika Anda menghapus versi yang dipublikasikan atau semua versi integrasi integrasi, langganan Pub/Sub juga akan dihapus.

Buat langganan dengan filter untuk integrasi Anda

Jika Anda ingin menyetel filter untuk langganan Pub/Sub agar dapat memproses peristiwa tertentu dalam integrasi, ikuti langkah-langkah berikut:

1. Publikasikan integrasi dengan pemicu Cloud Pub/Sub yang dikonfigurasi. Langkah ini akan membuat langganan dalam project integrasi.
2. Di konsol Google Cloud, buka halaman Langganan.

   Buka Langganan

3. Buka langganan dan salin semua detail, termasuk nama langganan.
4. Menghapus langganan yang ada.
5. Buat langganan baru dengan semua detail langganan yang dihapus–termasuk nama langganan–yang Anda salin pada langkah 3 dan juga tambahkan filter di langganan baru.

   Langganan yang baru dibuat memicu integrasi dengan pesan yang difilter.

Pengecualian SLA

Pemicu Cloud Pub/Sub bergantung pada produk Pub/Sub. Karena dependensi ini berada di luar Integrasi Aplikasi, persyaratan dan ketentuan Perjanjian Tingkat Layanan (SLA) Integrasi Aplikasi hanya berlaku jika pemicu Cloud Pub/Sub berhasil memulai eksekusi integrasi active.