Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu Rabbit MQ

Pemicu Rabbit MQ adalah Pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa Rabbit MQ yang telah Anda subscribe di koneksi Rabbit MQ.

Penting: Konektor Integrasi adalah komponen Google Cloud yang dapat ditagih. Untuk mengetahui informasi tentang biaya dan tagihan penggunaan Integration Connectors, lihat Harga Integration Connectors.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu Rabbit MQ, pastikan Anda memiliki peran IAM berikut di project:

• Connector Admin (roles/connectors.admin)

Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu Rabbit MQ:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Menambahkan pemicu Rabbit MQ

Untuk menambahkan pemicu Rabbit MQ 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 Rabbit MQ di editor integrasi.

Untuk mengonfigurasi pemicu Rabbit MQ, Anda dapat menggunakan koneksi Rabbit MQ yang ada di Konektor Integrasi, atau membuat koneksi Rabbit MQ baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu Rabbit MQ menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu Rabbit MQ menggunakan koneksi Rabbit MQ yang ada di Konektor Integrasi. Perhatikan bahwa pemicu Rabbit MQ adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi Rabbit MQ dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk informasi tentang cara mengonfigurasi pemicu Rabbit MQ menggunakan koneksi Rabbit MQ baru, lihat Mengonfigurasi pemicu Rabbit MQ menggunakan koneksi baru

Untuk mengonfigurasi pemicu Rabbit MQ menggunakan koneksi Rabbit MQ yang ada, lakukan langkah-langkah berikut:

1. Klik elemen Rabbit MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Region: Pilih region koneksi Rabbit MQ Anda.
   2. Koneksi: Pilih koneksi Rabbit MQ yang ingin Anda gunakan.

      Integrasi Aplikasi hanya menampilkan koneksi Rabbit MQ yang aktif dan mengaktifkan langganan peristiwa.

   3. Pilih Queue atau Topik sebagai JMS Source Type.
      • Jika Anda memilih Queue, berikan nama antrean Rabbit MQ di kolom JMS Source Name.
      • Jika Anda memilih Topic, berikan nama topik Rabbit MQ di kolom JMS Source Name.
   4. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu Rabbit MQ.
4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu Rabbit MQ menggunakan koneksi baru

Untuk mengonfigurasi pemicu Rabbit MQ menggunakan koneksi Rabbit MQ baru, lakukan langkah-langkah berikut:

1. Klik elemen Rabbit MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu.
3. Lewati kolom Region.
4. Klik Connection, lalu pilih opsi Create Connection dari menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Buat Koneksi:
   1. Pada langkah Location, pilih lokasi untuk koneksi Rabbit MQ baru:
      1. Region: Pilih region dari menu drop-down.
      2. Klik Berikutnya.
   2. Pada langkah Detail Koneksi, berikan detail tentang koneksi Rabbit MQ baru:
      1. Versi konektor: Pilih versi konektor Rabbit MQ yang tersedia dari menu drop-down.
      2. Nama Koneksi: Masukkan nama untuk koneksi Rabbit MQ.
         Catatan: Nama koneksi harus memenuhi kriteria berikut:

         • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
         • Huruf harus berupa huruf kecil.
         • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
         • Nama koneksi tidak boleh melebihi 63 karakter.
      3. (Opsional) Deskripsi: Masukkan deskripsi untuk koneksi.
      4. (Opsional) Aktifkan Cloud Logging: Centang kotak ini untuk menyimpan semua data log koneksi.
      5. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk koneksi Rabbit MQ.
      6. Aktifkan langganan peristiwa: Pilih opsi ini untuk mengaktifkan langganan peristiwa untuk koneksi Rabbit MQ.
         Catatan: Konektor ini tidak mendukung opsi Enable only event subscription.
      7. (Opsional) Luaskan Setelan lanjutan untuk mengonfigurasi setelan node koneksi.

         Untuk informasi selengkapnya tentang setelan node koneksi untuk Rabbit MQ, lihat dokumentasi Koneksi Rabbit MQ.

      8. (Opsional) Klik + Tambahkan label untuk menambahkan label ke koneksi dalam bentuk pasangan nilai kunci.
      9. Klik Berikutnya.
   3. Pada langkah Destinations, berikan detail instance Rabbit MQ:
      1. Jenis Tujuan: Pilih Alamat host.
      2. Host: Masukkan nama host atau alamat IP instance Rabbit MQ Anda.
      3. Klik Berikutnya.
   4. Jika ingin menggunakan SSL, pilih Enable SSL. Tindakan ini akan menampilkan detail konfigurasi SSL.
      1. Pilih jenis trust store. Status ini dapat berupa Publik, Pribadi, atau Koneksi Tidak Aman.
      2. Pilih sertifikat seperti yang ditampilkan berdasarkan pilihan penyimpanan kepercayaan Anda.
      3. Jika Anda menggunakan mTLS, pilih sertifikat penyimpanan kunci di bagian Penyimpanan Kunci.
      4. Atau, pilih versi TLS.
      5. Masukkan cipher suite yang didukung. Masukkan beberapa cipher suite, sebagai nilai yang dipisahkan koma. Untuk informasi selengkapnya, lihat Suite cipher yang didukung.
      Catatan:

      • Semua sertifikat Anda harus berupa sertifikat X.509 dan harus dalam format PEM (Privacy Enhanced Mail).
      • Anda tidak dapat langsung memilih sertifikat saat mengonfigurasi SSL. Anda harus menyimpan semua sertifikat dan kunci pribadi sebagai Secret Secret Manager, lalu memilih secret yang diperlukan selama konfigurasi SSL.
   5. Pada langkah Autentikasi, berikan detail autentikasi untuk instance Rabbit MQ:
      1. Pilih jenis autentikasi yang diinginkan dan masukkan detail yang relevan untuk mengakses URL host Rabbit MQ yang diberikan.

         Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

      2. Klik Berikutnya.
   6. Tinjau: Tinjau detail koneksi Rabbit MQ yang diberikan.
   7. Klik Create untuk menyelesaikan pembuatan koneksi Rabbit MQ baru.
6. Klik Selesai dan tutup halaman.

Cipher suite yang didukung

Versi TLS	Cipher suite yang didukung
1,2	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1,3	TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256

Output pemicu

Pemicu Rabbit MQ memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu pada bagian Detail Langganan Peristiwa.

Pemicu Rabbit MQ menunjukkan status langganan peristiwa menggunakan status berikut:

• Creating: Menunjukkan bahwa pemicu berlangganan langganan peristiwa.
• Active: Menunjukkan bahwa pemicu berhasil berlangganan langganan peristiwa.
• Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan peristiwa, bagian Detail Langganan Peristiwa juga menampilkan detail lainnya seperti wilayah koneksi, nama koneksi, dan nama langganan peristiwa.

Gambar berikut menunjukkan contoh tata letak panel konfigurasi pemicu Rabbit MQ:

Memicu variabel output

Untuk setiap peristiwa, pemicu Rabbit MQ menghasilkan variabel output ConnectorEventPayload (dalam format JSON) yang dapat Anda gunakan dalam tugas downstream. Variabel output akan memiliki payload dari peristiwa Rabbit MQ Anda. Contoh:

{
"message": "Hello world",
"messageContentType": "Text"
}

Melihat langganan peristiwa

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Konektor Integrasi, lakukan hal berikut:

1. Buka halaman Integration Connectors > Connections.

   Buka halaman Koneksi

2. Klik koneksi yang langganannya ingin Anda lihat.
3. Klik tab Langganan peristiwa.

   Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Mengedit pemicu RabbitMQ

Anda dapat mengedit pemicu Rabbit MQ untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Penting: Saat mengedit atau mengubah pemicu Rabbit MQ, Anda dapat mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya yang dilampirkan ke pemicu, atau Anda dapat menghapusnya. Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut.

Untuk mengedit pemicu Rabbit MQ, lakukan langkah-langkah berikut:

1. Klik elemen Rabbit MQ trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Konfigurasi pemicu Rabbit MQ.
3. Lakukan tindakan berikut di halaman Editor Pemicu Peristiwa Konektor:
   1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
      Peringatan: Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan menggunakan langganan peristiwa tersebut. Tugas ini tidak dapat diurungkan.
   2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
   3. Klik Done.

Anda dapat melihat detail koneksi dan langganan peristiwa yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya

• Pelajari semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari log eksekusi integrasi.