Pratinjau

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

Solace

Konektor Solace menyediakan konektivitas ke Solace.

Sebelum memulai

Sebelum menggunakan konektor Solace, lakukan tugas berikut:

• Di project Google Cloud Anda:
  • Memberikan peran IAM roles/connectors.admin kepada pengguna mengonfigurasi konektor.
  • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna yang perlu mengautentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk selengkapnya informasi, lihat Membuat akun layanan.

  • Aktifkan layanan berikut:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (API Konektor)

    Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

  Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

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

Mengonfigurasi konektor

Mengonfigurasi konektor mengharuskan Anda membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Ini berarti bahwa jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

1. Di Konsol Cloud, buka Integration Connectors > Halaman Koneksi lalu pilih atau buat project Google Cloud.

   Buka halaman Koneksi

2. Klik + CREATE NEW untuk membuka halaman Create Connection.
3. Di bagian Lokasi, pilih lokasi untuk koneksi.
   1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua wilayah yang didukung, lihat Lokasi.

   2. Klik Berikutnya.
4. 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 huruf kecil.
      • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh lebih dari 63 karakter.
   4. Jika perlu, masukkan Description untuk instance koneksi.
   5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
   6. Agar dapat menggunakan koneksi untuk langganan acara, pilih Aktifkan langganan acara. Memilih opsi ini, akan mengaktifkan langganan peristiwa dengan tindakan.
      Catatan: Opsi Enable only event subscription tidak didukung untuk koneksi ini.
   7. Message VPN: Router pesan Solace Pub/Sub+ VPN yang ingin Anda hubungkan. Koneksi bersifat khusus untuk Message VPN. Jika Anda memiliki banyak VPN pesan, Anda harus membuat untuk setiap VPN pesan.
   8. Nama Antrean Default: Nama antrean default dapat diganti saat menjalankan tindakan.
   9. Nama Topik Default: Nama topik yang akan dihubungkan.
   10. Anda juga dapat mengonfigurasi Setelan node koneksi:
       • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
       • Jumlah maksimum node: Masukkan jumlah maksimum node koneksi.

       Simpul adalah unit (atau replika) koneksi yang memproses transaksi. Diperlukan lebih banyak {i>node<i} untuk memproses lebih banyak transaksi untuk koneksi dan sebaliknya, lebih sedikit node yang diperlukan 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 ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

   Catatan: Anda dapat menyesuaikan nilai node koneksi hanya jika Anda pelanggan Bayar sesuai penggunaan.
   11. Anda juga dapat mengklik + Add label untuk menambahkan label ke Koneksi dalam bentuk key-value pair.
   12. Klik Berikutnya.
5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
   1. Jenis Tujuan: Pilih Jenis Tujuan.
      • Pilih Host address dari daftar untuk menentukan nama host atau alamat IP tujuan.
      • Jika Anda ingin membuat koneksi pribadi ke sistem backend Anda, pilih Endpoint attachment dari daftar, lalu pilih lampiran endpoint yang diperlukan dari daftar Endpoint Lampiran.
        Catatan: Untuk memahami cara membuat lampiran endpoint, lihat Lampiran layanan PSC dan lampiran endpoint. Setelah Anda telah membuat lampiran endpoint, lampiran tersebut akan dapat dilihat di daftar Lampiran Endpoint.

      Jika Anda ingin membuat koneksi publik ke sistem {i> backend<i} dengan keamanan tambahan, Anda dapat pertimbangkan untuk mengonfigurasi jaringan keluar statis alamat IP untuk koneksi Anda, lalu konfigurasikan aturan firewall untuk hanya mengizinkan alamat IP statis tertentu ke daftar yang diizinkan.

      Catatan: Konektor ini hanya mendukung satu tujuan.
   2. Klik Berikutnya.
6. Di bagian Authentication, masukkan detail autentikasi.
   1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi Solace:

      • Anonim
      • Nama pengguna dan {i>password<i}

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

   2. Klik Berikutnya.
7. Peninjauan: Tinjau detail koneksi dan autentikasi Anda.
8. Klik Create.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

• Anonim

  Jika Anda ingin menggunakan login anonim, pilih Tidak Tersedia.

• Nama pengguna dan sandi
  • Nama pengguna: Nama pengguna Solace yang akan digunakan untuk koneksi.
  • Sandi: Secret Manager Secret yang berisi sandi yang terkait dengan nama pengguna Solace.

Entity, operasi, dan tindakan

Semua Integration Connectors menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini diekspos kepada Anda sebagai entity, operasi, dan tindakan.

Catatan: Anda dapat melihat entitas, operasi, dan tindakan Connector di tugas Connectors.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, di aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke entitas konektor 20%. Misalnya, dalam konektor {i>database<i}, tabel adalah entitas, dalam konektor server file, folder adalah entitas, dan dalam konektor sistem pesan, antrean adalah entitas.

  Namun, mungkin saja konektor tidak mendukung atau memiliki entitas apa pun. Dalam hal ini, Daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entitas. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Cantumkan
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih sebuah entitas dari daftar yang tersedia akan menghasilkan daftar yang tersedia untuk entity tersebut. Untuk deskripsi operasi yang terperinci, lihat tugas Konektor operasi entity. Namun, jika konektor tidak mendukung operasi entity apa pun, seperti operasi tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada suatu entitas atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Biasanya, suatu tindakan akan memiliki beberapa parameter input, dan output . Namun, mungkin saja bahwa konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Catatan: Semua entitas dan tindakan akan memiliki skema yang terkait dengannya. Misalnya, skema tindakan akan memiliki detail parameter seperti; parameter nama, dan tipe datanya yang sesuai. Skema (metadata) untuk entity dan tindakan diambil oleh koneksi di runtime dari backend Anda. Jika ada pembaruan pada skema, pembaruan tersebut tidak akan secara otomatis tercermin dalam koneksi Anda yang sudah ada; Anda harus memperbarui skema secara manual. Untuk memuat ulang skema untuk koneksi, buka halaman Connection details dari koneksi, lalu klik Muat ulang skema koneksi.

Tindakan

Koneksi Solace mendukung tindakan berikut:

• sendMessage Mengirim pesan ke antrean.
• requestReply: Mengirim pesan ke antrean dan juga menentukan antrean respons di mana penulis balas harus menulis respons.

Tindakan sendMessage

Tabel berikut menjelaskan parameter input dan output dari tindakan sendMessage.

Parameter input tindakan sendMessage

Nama parameter	Wajib	Jenis data	Deskripsi
message	Ya	String	Pesan yang akan dikirim ke antrean Solace. Saat ini, ukuran pesan maksimum yang didukung adalah 10 MB.
queueName	Tidak	String	Nama antrean Solusi. Jika Anda tidak menentukan nama antrean, nama antrean default yang ditentukan selama pembuatan koneksi akan digunakan.
messageContentType	Ya	String	Jenis isi pesan yang dapat Anda tentukan sebagai Text atau Bytes. Anda harus menetapkan jenis ke Bytes jika Anda mengirim data biner. Untuk mengirim pesan dalam format biner, Anda harus melakukan tugas-tugas berikut: Lakukan enkode pesan biner sebagai string Base64, lalu setel message parameter ke nilai yang dienkode. Setel nilai parameter messageContentType ke Bytes.
messageType	Ya	String	Jenis pesan yang dapat Anda tentukan sebagai Datagram atau Reply.
topicName	Tidak	String	Nama topik Solace. Jika Anda tidak menentukan nama topik, nama antrean default yang ditentukan selama pembuatan koneksi akan digunakan.

Parameter output dari tindakan sendMessage

Nama parameter	Jenis data	Deskripsi
messageId	String	ID pesan yang dikirim.

Contoh

Payload berikut digunakan untuk mengirim Pesan Teks Datagram ke antrean.

  {
    "message": "Hello world",
    "messageContentType": "Text",
    "messageType": "Datagram",
    "queueName": "solace-queue"
  }

Payload output terlihat mirip dengan berikut ini:

[{
    "messageId": "ID:414d51207365637572*******6501db3640"
}]

Payload berikut digunakan untuk mengirim Pesan Byte Balasan ke suatu topik.

{
    "message": "NDggNjUgNmMgNmMgNmYgMjAgNTcgNmYgNzIgNmMgNjQ=",
    "messageContentType": "Bytes",
    "messageType": "Reply",
    "topicName": "solace-topic"
}

Payload output terlihat mirip dengan berikut ini:

[{
  "messageId": "ID:414d512073656375726561707068656ce595386501db3640"
}]

Tindakan requestReply

Tabel berikut menjelaskan parameter input dan output dari tindakan requestReply.

Parameter input dari tindakan requestReply

Nama parameter	Wajib	Jenis data	Deskripsi
message	Ya	String	Pesan yang akan dikirim ke antrean Solace. Ukuran pesan maksimum yang didukung adalah 10 MB.
queueName	Tidak	String	Nama antrean Solusi. Jika Anda tidak menentukan nama antrean, nama antrean default yang ditentukan selama pembuatan koneksi akan digunakan.
messageContentType	Ya	String	Jenis isi pesan yang dapat Anda tentukan sebagai Text atau Bytes. Anda harus menetapkan jenis ke Bytes jika Anda mengirim data biner. Untuk mengirim pesan dalam format biner, Anda harus melakukan tugas-tugas berikut: Lakukan enkode pesan biner sebagai string Base64, lalu setel message parameter ke nilai yang dienkode. Setel nilai parameter messageContentType ke Bytes.
replyToQueue	Ya	String	Antrean tempat penulis balasan harus menulis respons.
replyTimeout	Ya	String	Waktu (dalam milidetik) hingga konektor menunggu respons dalam antrean respons. Nilai maksimum yang didukung adalah 180.000 milidetik (3 menit). Jika antrean respons menerima pesan setelah periode waktu tunggu habis, maka pesan tersebut tidak yang diproses oleh konektor. Namun, Anda dapat melihat detail pesan dengan waktu habis di log eksekusi integrasi Anda. Catatan: Menetapkan nilai waktu tunggu yang lebih tinggi dapat memengaruhi performa konektor.

Parameter output dari tindakan requestReply

Nama parameter	Jenis data	Deskripsi
replyMessage	String	Pesan respons dari penulis balasan.

Contoh

Payload berikut digunakan untuk mengirim pesan respons dari penulis balasan.

{
  "message": "Hello world",
  "messageContentType": "Text",
  "queueName": "solace-queue",
  "replyToQueue": "solace-reply-queue",
  "replyTimeout": 10
}

Payload output terlihat mirip dengan berikut ini:

{
    "replyMessage": "Message received"
}

Menggunakan terraform untuk membuat koneksi

Anda dapat menggunakan Terraform resource untuk membuat koneksi baru.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Guna melihat contoh template terraform untuk pembuatan koneksi, lihat contoh template.

Saat membuat koneksi ini menggunakan Terraform, Anda harus menetapkan variabel berikut dalam file konfigurasi Terraform:

Nama parameter	Jenis data	Wajib	Deskripsi
default_queue_name	STRING	Salah	Nama antrean default, dapat diganti saat menjalankan tindakan.
default_topic_name	STRING	Salah	Nama topik default, dapat diganti saat menjalankan tindakan.
queue_manager_name	STRING	Benar	Nama Pengelola Antrean yang akan dihubungkan.
channel_name	STRING	Benar	Saluran yang akan dihubungkan ke Pengelola Antrean.

Menggunakan koneksi Solace dalam integrasi

Setelah dibuat, koneksi akan tersedia di Integrasi Apigee dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Connectors.

• Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
• Untuk memahami cara membuat dan menggunakan tugas Konektor di Application Integration, lihat Tugas konektor.

Dapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di Google Cloud di Forum Cloud.

Langkah selanjutnya

• Pahami cara menangguhkan dan melanjutkan koneksi.
• Pahami cara memantau penggunaan konektor.
• Memahami cara melihat log konektor.