Mulai Menggunakan Integrasi Apigee dan 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

Pelajari cara membuat contoh integrasi menggunakan Integrasi Apigee dan pemicu Cloud Pub/Sub. Langkah-langkah berikut menjelaskan cara mengonfigurasi pemicu, tugas, variabel, dan pemetaan data yang diperlukan untuk menjalankan integrasi lengkap.

Ringkasan

Dalam panduan memulai ini, Anda akan membuat integrasi dengan pemicu Cloud Pub/Sub untuk memproses topik Pub/Sub yang sudah ada yang menerima pembacaan suhu dalam derajat Kelvin dari perangkat IOT. Kemudian, Anda dapat menggunakan tugas Pemetaan Data untuk mengubah pesan Pub/Sub ke celsius dan mengirim nilainya dalam email.

Sebelum memulai

Pastikan Anda melakukan tugas berikut sebelum memulai panduan memulai:

• Tetapkan peran IAM berikut ke Apigee Integration Service Agent ([e-mail]) di project Google Cloud Anda.
  • Editor Pub/Sub
  • Invoker Integrasi Apigee

    Untuk mengetahui informasi selengkapnya tentang penetapan peran IAM, lihat Peran dan izin IAM.

Lingkungan penyiapan

Membuat topik Cloud Pub/Sub baru

Panduan memulai ini mengasumsikan bahwa Anda memiliki topik Pub/Sub yang menerima pembacaan suhu dalam derajat Kelvin dari perangkat IOT. Anda tidak harus benar-benar menghubungkan topik ke perangkat. Panduan memulai ini menguji kemampuan integrasi untuk memproses topik dan menjalankan tugas saat dipicu.

Cara membuat topik contoh untuk tujuan panduan memulai ini:

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. Misalnya, temperaturesensor
4. Klik Save.
   Catatan: Langganan tidak diperlukan untuk memicu integrasi.

Membuat integrasi baru

Untuk membuat integrasi baru, lakukan langkah-langkah berikut:

1. Di UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Klik Create integration.
4. Masukkan nama dan deskripsi dalam dialog Create Integration. Misalnya, my-test-integration.
   Catatan: Nama integrasi harus memenuhi persyaratan berikut:

   • Nama harus diawali dan diakhiri dengan huruf atau angka.
   • Nama tidak boleh berisi spasi atau lebih dari satu tanda hubung atau garis bawah dalam satu baris.
5. 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.
6. Klik Create untuk membuka editor integrasi.

Menambahkan pemicu Cloud Pub/Sub

Untuk menambahkan pemicu Cloud Pub/Sub ke integrasi, ikuti langkah-langkah berikut:
1. Di editor integrasi, pilih Pemicu untuk menampilkan daftar pemicu yang tersedia.
2. 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.

Tentukan topik yang akan dideteksi pemicu di kolom Pub/Sub topic dalam format berikut:

projects/PROJECT_ID/topics/TOPIC_ID

di mana:
• PROJECT_ID adalah project Google Cloud tempat topik Anda dibuat.
• TOPIC_ID adalah ID topik Cloud Pub/Sub yang Anda buat di bagian Sebelum memulai.

Misalnya, jika project diberi nama my-project dan Anda menamai topik temperaturesensor, masukkan:

projects/my-project/topics/temperaturesensor.

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

Panel konfigurasi pemicu Cloud Pub/Sub akan otomatis mengisi kolom Output Pemicu dengan variabel untuk menyimpan pesan Pub/Sub.

Menambahkan dan mengonfigurasi tugas Pemetaan Data

Untuk mengonfigurasi tugas Pemetaan Data:

1. Pilih Tasks untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Data Mapping di editor integrasi.
3. Klik tugas Data Mapping pada desainer untuk membuka panel konfigurasi tugas tersebut.
4. Klik Open Data Mapping Editor.

   Data Mapping Editor memungkinkan Anda memetakan variabel input ke variabel output yang diinginkan, menggunakan fungsi transformasi yang tersedia. Outputnya kemudian tersedia sebagai variabel untuk pemicu atau tugas integrasi lainnya. Untuk detail selengkapnya tentang meneruskan data sebagai variabel, lihat Menggunakan variabel dalam Integrasi Apigee.

   Untuk panduan memulai ini, ikuti langkah-langkah berikut untuk membuat pemetaan menggunakan CloudPubSubMessage sebagai input:

   1. Luaskan variabel JSON CloudPubSubMessage di daftar Variabel, lalu tarik variabel CloudPubSubMessage.data ke baris Input pertama.
   2. Klik + (Add a function) di samping variabel CloudPubSubMessage.data untuk melihat menu drop-down fungsi yang tersedia.
   3. Pilih TO_DOUBLE() untuk mengonversi nilai CloudPubSubMessage.data menjadi jenis data double.
   4. Klik + (Add a function) lagi untuk memilih dan merangkai fungsi SUBTRACT.
   5. Masukkan 273.15 sebagai nilai fungsi SUBTRACT. Fungsi ini untuk mengonversi suhu Kelvin ke derajat Celsius.
   6. Klik baris pertama di kolom Output untuk membuat variabel output baru guna menyimpan nilai data yang diubah. Lengkapi kolom berikut:
      • Nama: Masukkan TempInCelsius.
      • Centang Use as an output of integration.
      • Klik Create untuk membuat variabel dan menutup panel. Variabel TempInCelsius baru akan muncul dalam daftar Variabel.
   7. Tarik variabel TempInCelsius dari daftar Variabel ke baris kedua di kolom Input.
   8. Klik + (Add a function) dalam variabel TempInCelsius untuk melihat menu drop-down fungsi yang tersedia.
   9. Klik TO_STRING() untuk mengubah jenis data variabel dari double menjadi string.
   10. Klik baris kedua di kolom Output untuk membuat variabel baru yang menyimpan nilai data yang diubah. Lengkapi kolom berikut:
       • Nama: Masukkan TempInCelsiusString.
       • Nilai default kosong berarti: Pilih Empty String.
       • Centang kotak Use as an output of integration.
       • Klik Create untuk membuat variabel dan menutup panel. Variabel baru akan muncul dalam daftar Variabel di sisi kiri editor pemetaan data.
   11. Tutup Data Mapping Editor setelah pemetaan selesai. Setiap perubahan akan disimpan otomatis.

Menambahkan dan mengonfigurasi tugas Kirim Email

Untuk mengonfigurasi tugas Kirim Email:

1. Pilih Tasks di editor integrasi untuk menampilkan daftar tugas yang tersedia.
2. Klik dan tempatkan elemen Send Email di editor integrasi.
3. Klik elemen Send Email pada desainer untuk membuka panel konfigurasi tugas. Tetapkan properti berikut:
   • Kepada Penerima: Masukkan alamat email Anda. Anda akan menggunakan email ini untuk mengonfirmasi bahwa integrasi berhasil diselesaikan.
   • Subject: Masukkan Temperature in Celsius.
   • Body in Plain Text: Pilih variabel TempInCelsiusString yang dibuat sebelumnya di tugas Data Mapping.
   • Opsi lainnya dapat dibiarkan dalam konfigurasi default.
   Perubahan Anda pada properti disimpan secara otomatis.

Tambahkan koneksi edge yang diperlukan

Tepi adalah hubungan antara dua elemen dalam integrasi. Koneksi menunjukkan arah alur kontrol dari satu elemen(tugas atau pemicu) ke elemen lainnya. Untuk mengetahui informasi selengkapnya tentang edge, lihat Edge.

1. Tambahkan koneksi edge dari elemen pemicu Cloud Pub/Sub ke elemen Data Mapping dengan mengarahkan kursor ke titik kontrol di elemen trigger Cloud Pub/Sub, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Pemetaan Data. Tepi ini menunjukkan alur kontrol dari tugas pemicu Cloud Pub/Sub ke tugas Data Mapping.
2. Tambahkan koneksi edge dari elemen Data Mapping ke elemen Send Email dengan mengarahkan kursor ke titik kontrol di elemen Data Mapping, lalu mengklik dan menarik garis ke titik kontrol pada elemen tugas Send Email. Tepi ini menunjukkan alur kontrol dari tugas Data Mapping ke tugas Send Email.

Koneksi yang telah selesai akan muncul seperti yang ditunjukkan dalam gambar di bawah ini:



Menguji integrasi

Untuk menguji integrasi baru dari halaman topik Pub/Sub, lakukan langkah-langkah berikut:

1. Buka halaman topik Pub/Sub di Cloud Console.

   Buka halaman topik Pub/Sub

2. Telusuri, lalu pilih topik suhu sensor yang Anda buat.
3. Dari halaman topic details, klik + Publish Message untuk membuka panel konfigurasi Publish Message.
4. Di kolom Isi pesan, masukkan 307.15.

   Pembuatan pesan ini akan menyimulasikan publikasi pembacaan suhu dalam Kelvin yang diterima oleh Pub/Sub dari perangkat IOT.

5. Klik Publikasikan untuk memublikasikan pesan ke topik dan memicu integrasi Anda.

Setelah berhasil diselesaikan, integrasi akan mengirimkan email dengan suhu Kelvin yang dikonversi ke derajat Celsius ke alamat email yang ditentukan dalam tugas Send Email. Konfirmasi penerimaan email di program email Anda.

Email yang dikirim oleh integrasi harus memiliki isi pesan yang berisi nilai 34.

Selain memverifikasi konten email, Anda dapat memeriksa log untuk melihat status dan payload integrasi yang diberikan. Untuk melihat log:

1. Di editor integrasi, klik Lihat log eksekusi untuk integrasi ini. Halaman Execution Logs akan muncul. Untuk informasi selengkapnya tentang log eksekusi, buka Melihat log eksekusi integrasi.
2. Di halaman Log Eksekusi, Anda dapat melihat detail setiap upaya untuk menjalankan integrasi. Setiap entri menyertakan detail upaya eksekusi, termasuk:
   • Nama integrasi
   • ID eksekusi
   • Status
   • Waktu mulai
   • Durasi
   • Versi Integrasi
   • ID Pemicu
3. Klik panah peluas (>) di samping integrasi yang dijalankan untuk melihat daftar tugas dan variabel yang diperluas dalam integrasi, beserta status tugas dan payload variabel.