Pemicu Solace

Pratinjau — Pemicu Solace

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Pemicu Solace adalah pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa Solace yang telah Anda langgan di koneksi Solace.

Penting: Integration Connectors 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 Solace, pastikan Anda memiliki peran IAM berikut di project:

• Admin Konektor (roles/connectors.admin)

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

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

• Pemanggil Integrasi Application Integration (roles/integrations.integrationInvoker)

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

Catatan: Pemicu Solace mendukung protokol JMS (Java Message Service). Protokol lain, seperti MQTT dan AMQP, tidak didukung.

Menambahkan pemicu Solace

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

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

   Buka Application Integration

2. Di menu navigasi, klik Integrations

   Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Create integration untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Menu dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan region baru, klik Enable Region. Lihat Mengaktifkan region baru untuk mengetahui 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 region yang dipilih.
   4. Klik Create.

   Integrasi yang baru dibuat akan terbuka di editor integrasi.

4. Di panel navigasi editor integrasi, klik Triggers untuk melihat daftar pemicu yang tersedia.
5. Klik dan tempatkan elemen Solace trigger di editor integrasi.

Untuk mengonfigurasi pemicu Solace, Anda dapat menggunakan koneksi Solace yang ada dan tersedia di Integration Connectors, atau membuat koneksi Solace baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu Solace menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu Solace menggunakan koneksi Solace yang ada di Integration Connectors. Perhatikan bahwa pemicu Solace adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi Solace dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu Solace menggunakan koneksi Solace baru, lihat Mengonfigurasi pemicu Solace menggunakan koneksi baru

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

1. Klik elemen Solace trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Configure trigger.
3. Berikan detail konfigurasi berikut di halaman Connector Event Trigger Editor :
   1. Region: Pilih region koneksi Solace Anda.
   2. Connection: Pilih koneksi Solace yang ingin Anda gunakan.

      Application Integration hanya menampilkan koneksi Solace yang aktif dan memiliki langganan peristiwa yang diaktifkan.

   3. Pilih Queue atau Topic sebagai JMS Source Type.
      • Jika Anda memilih Queue, berikan nama antrean Solace di kolom JMS Source Name.
      • Jika Anda memilih Topic, berikan nama topik Solace di kolom JMS Source Name.
   4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu Solace.
4. Klik Done untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu Solace menggunakan koneksi baru

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

1. Klik elemen Solace trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
2. Klik Configure trigger.
3. Lewati kolom Region.
4. Klik Connection , lalu pilih opsi Create Connection dari menu drop-down.
5. Selesaikan langkah-langkah berikut di panel Create Connection :
   1. Pada langkah Location, pilih lokasi untuk koneksi Solace baru:
      1. Region: Pilih lokasi dari menu drop-down.

         Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

      2. Klik Next.
   2. Di bagian Connection Details, selesaikan langkah-langkah berikut:
      1. Konektor: Pilih Solace dari menu drop-down Konektor yang tersedia.
      2. Versi Konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
      3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.

         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 49 karakter.
         • Untuk konektor yang mendukung langganan peristiwa, nama koneksi tidak boleh diawali dengan awalan "goog".
      4. Secara opsional, masukkan Description untuk instance koneksi.
      5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
      6. Untuk menggunakan koneksi untuk langganan peristiwa, pilih Enable event subscription. Memilih opsi ini akan mengaktifkan langganan peristiwa dengan tindakan.
         Catatan: Opsi Enable only event subscription tidak didukung untuk koneksi ini.
      7. Message VPN: Message VPN router pesan Solace Pub/Sub+ yang ingin Anda hubungkan. Koneksi khusus untuk Message VPN. Jika Anda memiliki banyak Message VPN, Anda harus membuat koneksi terpisah untuk setiap Message VPN.
      8. Nama Antrean Default: Nama antrean default, dapat diganti saat menjalankan tindakan.
      9. Default Topic Name: Nama topik yang akan dihubungkan.
      10. (Opsional) Untuk menggunakan SSL, pilih Enable SSL dan tentukan detail konfigurasi SSL.
      1. Pilih jenis trust store. Anda dapat menentukan Public, Private, atau Insecure Connection.
      2. Pilih sertifikat berdasarkan pilihan trust store Anda. Misalnya, jika Anda memilih Private, tentukan trust store kustom.
      3. Jika Anda menggunakan mTLS, pilih sertifikat key store di bagian Key Store.
      4. Secara opsional, pilih versi TLS.
      5. Masukkan cipher suite yang didukung. Masukkan beberapa cipher suite, sebagai nilai yang dipisahkan koma. Untuk mengetahui informasi selengkapnya, lihat Cipher suite 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 Manager Secret, lalu memilih secret yang diperlukan selama konfigurasi SSL.
      11. (Opsional) Konfigurasi Connection node settings.
      • Minimum number of nodes: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Diperlukan lebih banyak node untuk memproses lebih banyak transaksi untuk koneksi dan sebaliknya, diperlukan lebih sedikit node untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum akan ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum akan ditetapkan ke 50.

      Catatan: Anda hanya dapat menyesuaikan nilai node koneksi jika Anda adalah pelanggan dengan model pembayaran sesuai penggunaan.
      12. Secara opsional, klik + Add label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
      13. Klik Next.
   3. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
      1. Destination Type: Pilih Destination Type.
         • Untuk menentukan nama host atau alamat IP tujuan, pilih Host address dan masukkan alamat di kolom host 1.
         • Untuk membuat koneksi pribadi, pilih Endpoint attachment. Di daftar Endpoint Attachment, pilih lampiran endpoint yang dibuat untuk sistem backend Anda.
         Catatan: Untuk mempelajari cara membuat lampiran endpoint, lihat Konektivitas jaringan pribadi. Setelah dibuat, lampiran endpoint akan terlihat di daftar Endpoint Attachment.

         Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan untuk mengonfigurasi alamat IP keluar statis untuk koneksi, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.

         Catatan: Konektor ini hanya mendukung satu tujuan.
      2. Klik Next.
   4. Di bagian Authentication, masukkan detail autentikasi.
      1. Pilih Authentication type , lalu masukkan detail yang relevan.

         Jenis autentikasi berikut didukung oleh koneksi Solace:

         • Anonim
         • Nama pengguna dan sandi

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

      2. Klik Next.
   5. Di bagian Event Subscription Details, konfigurasi detail terkait peristiwa.
      • Masukkan konfigurasi dead-letter. Jika Anda mengonfigurasi dead-letter, koneksi akan menulis peristiwa yang tidak diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
        1. Dead-letter project ID: ID project Google Cloud tempat Anda mengonfigurasi topik Pub/Sub dead-letter.
        2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang tidak diproses.
   6. Review: Tinjau detail koneksi dan autentikasi Anda.
   7. Klik Create.

   Output pemicu

   Pemicu Solace memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu di bagian Event Subscription details.

   Pemicu Solace menunjukkan status langganan peristiwa menggunakan status berikut:

   • Creating: Menunjukkan bahwa pemicu sedang 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 Event Subscription details juga menampilkan detail lainnya seperti region koneksi, nama koneksi, dan nama langganan peristiwa.

   Variabel output pemicu

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

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

   Melihat langganan peristiwa

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

   1. Buka halaman Integration Connectors > Connections.

      Buka halaman Koneksi

   2. Klik koneksi yang langganannya ingin Anda lihat.
   3. Klik tab Event subscriptions.

      Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

   Mengedit pemicu Solace

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

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

   Untuk mengedit pemicu Solace, lakukan langkah-langkah berikut:

   1. Klik elemen Solace trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
   2. Klik Configure Solace trigger.
   3. Lakukan hal berikut di halaman Connector Event Trigger Editor :
      1. Untuk mempertahankan langganan peristiwa yang sebelumnya dikonfigurasi, klik Retain, atau klik Delete.
         Peringatan: Menghapus langganan peristiwa akan memengaruhi semua integrasi yang dipublikasikan dan 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 Event Subscription details.

   Kuota dan batas

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

   Langkah berikutnya

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