Pemicu Cloud Pub/Sub

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 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. Saat dijalankan, pemicu ini juga akan menulis pesan yang dipublikasikan ke variabel output CloudPubSubMessage. Berdasarkan persyaratan, Anda dapat menggunakan variabel ini dalam tugas atau pemicu downstream.

Catatan: Topik yang Anda konfigurasi untuk pemicu harus tersedia di project Google Cloud yang sama dengan integrasi Anda. Apigee tidak mendukung eksekusi pemicu Cloud Pub/Sub di berbagai project Google Cloud.

Sebelum memulai

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

• Tetapkan peran IAM berikut ke akun layanan default ([e-mail]):
• 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. Apigee secara otomatis membuat langganan untuk sebuah topik, dan Anda dapat melihat semua langganan di halaman langganan Pub/Sub.

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 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 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:

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.

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.