Mengonfigurasi pemicu Eventarc

Pratinjau Pribadi

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.

Halaman ini menjelaskan cara mengonfigurasi pemicu Eventarc di Application Integration.

Pemicu Eventarc memungkinkan Anda menjalankan integrasi berdasarkan peristiwa yang dirutekan melalui Eventarc Standard. Dengan pemicu Eventarc, Anda dapat membuat alur integrasi yang dipicu oleh peristiwa dari berbagai Google Cloud layanan, layanan pihak ketiga, dan sumber peristiwa kustom. Misalnya, Anda dapat menggunakan pemicu untuk memulai integrasi saat objek baru diupload ke bucket Cloud Storage.

Di Google Cloud konsol, Anda dapat membuat dan mengonfigurasi pemicu Eventarc dengan cara berikut:

• Menggunakan Application Integration
• Menggunakan Eventarc

Sebelum memulai

Sebelum mengonfigurasi pemicu Eventarc, aktifkan Eventarc API dan Pub/Sub API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Aktifkan API

Pertimbangan

Pertimbangkan hal berikut saat mengonfigurasi pemicu Eventarc:

• Jika pembuatan pemicu Eventarc gagal selama publikasi integrasi karena error konfigurasi, integrasi Anda akan tetap dipublikasikan, tetapi pemicu tidak akan aktif.

  Untuk memperbaikinya, batalkan publikasi integrasi, tinjau dan perbaiki konfigurasi pemicu Eventarc dengan cermat, lalu publikasikan kembali integrasi. Anda dapat memeriksa status pembuatan pemicu Eventarc dengan mengklik (Notifikasi) di tool bar konsol Google Cloud.

• Memublikasikan versi baru integrasi Anda dengan konfigurasi pemicu Eventarc yang diubah akan otomatis mengganti pemicu lama dengan pemicu baru. Hal ini memastikan integrasi Anda selalu menggunakan konfigurasi pemicu terbaru dan menghapus pemicu yang tidak digunakan.
• Jika Anda memublikasikan versi baru integrasi dan menggunakan pemicu Eventarc yang sama serta konfigurasinya, pemicu baru tidak akan dibuat. Sebagai gantinya, pemicu Eventarc yang ada akan digunakan kembali untuk versi integrasi baru Anda.

Membuat pemicu Eventarc dari Application Integration

Untuk membuat pemicu Eventarc dari Application Integration, lakukan langkah-langkah berikut:

1. Tambahkan pemicu Eventarc di Application Integration
2. Konfigurasi pemicu Eventarc di editor integrasi

Menambahkan pemicu Eventarc

Untuk menambahkan pemicu Eventarc ke integrasi Anda, selesaikan 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: 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. Tarik lalu lepas elemen Eventarc di editor integrasi.

Mengonfigurasi pemicu Eventarc

Untuk mengonfigurasi pemicu Eventarc, klik elemen Eventarc Trigger di editor integrasi. Panel konfigurasi Eventarc Trigger akan muncul dan menampilkan kolom berikut:

• Label: (opsional) nama pemicu Eventarc yang terlihat dalam integrasi Anda. Anda dapat mengubah label ke nama pilihan Anda.
• Notes: (opsional) Anda dapat menambahkan catatan untuk memberikan informasi tambahan tentang pemicu.
• Klik Configure Eventarc trigger dan berikan input berikut di Eventarc trigger editor:
  • Nama pemicu: masukkan nama untuk pemicu.
  • Jenis pemicu: pilih salah satu jenis pemicu berikut:
    • Sumber Google: pilih opsi ini untuk membuat pemicu bagi Pub/Sub, Cloud Storage, Firestore, dan penyedia peristiwa Google lainnya.
    • Kustom: pilih opsi ini untuk membuat pemicu bagi sumber peristiwa kustom.
    • Third-party: pilih opsi ini untuk membuat pemicu bagi penyedia non-Google yang menawarkan sumber Eventarc. Untuk mengetahui informasi selengkapnya, lihat Peristiwa pihak ketiga di Eventarc.
  • Penyedia peristiwa: pilih penyedia peristiwa untuk pemicu. Daftar penyedia peristiwa bergantung pada jenis pemicu. Untuk mengetahui informasi selengkapnya, lihat Penyedia dan tujuan peristiwa.
  • Jenis peristiwa: pilih jenis peristiwa untuk pemicu. Konfigurasi pemicu Anda bervariasi berdasarkan penyedia peristiwa yang Anda pilih. Untuk mengetahui informasi selengkapnya, lihat Jenis peristiwa.
  • Region: pilih region untuk pemicu.
    Tips: Untuk performa optimal dan meminimalkan latensi, pastikan pemicu Eventarc, monitored Google Cloud resource, dan layanan Anda berada di region yang sama. Google Cloud
  • Filter: (opsional) tambahkan filter untuk memilih API yang sesuai dengan kriteria Anda. Misalnya, jika Anda memfilter API berdasarkan nama tertentu, peristiwa hanya akan dipicu jika API yang cocok dengan kriteria filter diperbarui.
  • Akun layanan: pilih akun layanan yang akan digunakan untuk pemicu. Jika Anda tidak memilih akun layanan, pemicu akan menggunakan akun layanan default Compute Engine sebagai identitasnya saat memanggil layanan Anda. Akun layanan yang terkait dengan pemicu harus memiliki izin yang diperlukan untuk memanggil layanan Anda.

  • Coba lagi saat gagal: pilih untuk mengaktifkan percobaan ulang pemicu jika tujuan gagal memproses peristiwa.
  • Lampiran jaringan: pilih lampiran jaringan yang akan digunakan untuk pemicu. Daftar ini dibuat berdasarkan lampiran jaringan yang dibuat di project Anda.

    Lampiran jaringan memfasilitasi komunikasi antara jaringan Virtual Private Cloud (VPC) produsen layanan dan jaringan VPC konsumen. Eventarc menggunakan lampiran jaringan yang dikonfigurasi untuk membuat koneksi ke endpoint HTTP internal yang dihosting dalam jaringan VPC konsumen, sehingga memungkinkan pengiriman data peristiwa. Untuk mengetahui informasi selengkapnya tentang cara membuat dan mengelola lampiran jaringan, lihat Membuat dan mengelola lampiran jaringan.

• Untuk menyimpan konfigurasi pemicu, klik Save trigger.
Catatan: Menyimpan konfigurasi pemicu Eventarc akan menentukan aturan yang menentukan kapan dan bagaimana Eventarc merespons peristiwa. Konfigurasi ini disimpan sebagai bagian dari definisi pemicu Anda di Application Integration. Namun, aturan ini tidak langsung diterapkan. Anda harus memublikasikan integrasi untuk men-deploy aturan ini dan mengaktifkan pemicu Eventarc. Hingga dipublikasikan, pemicu akan tetap tidak aktif dan tidak memproses peristiwa. Untuk mengetahui informasi tentang cara memublikasikan integrasi, lihat Memublikasikan integrasi.

Membuat pemicu Eventarc menggunakan konsol Eventarc

Untuk membuat pemicu Eventarc dari halaman konsol Eventarc, lakukan langkah-langkah berikut:

1. Di Google Cloud konsol, buka halaman Eventarc > Triggers.

   Buka Pemicu

   Halaman Triggers mencantumkan semua pemicu di project Anda.

2. Klik Create trigger.
3. Di halaman Create trigger, berikan input berikut:
   1. Nama pemicu: masukkan nama untuk pemicu.
   2. Jenis pemicu: pilih salah satu jenis pemicu berikut:
      • Google sources: pilih opsi ini untuk membuat pemicu bagi Pub/Sub, Cloud Storage, Firestore, dan penyedia peristiwa Google lainnya.
      • Kustom: pilih opsi ini untuk membuat pemicu bagi sumber peristiwa kustom.
      • Third-party: pilih opsi ini untuk membuat pemicu bagi penyedia non-Google yang menawarkan sumber Eventarc. Untuk mengetahui informasi selengkapnya, lihat Peristiwa pihak ketiga di Eventarc.
   3. Penyedia peristiwa: pilih penyedia peristiwa untuk pemicu. Daftar penyedia peristiwa bergantung pada jenis pemicu. Untuk mengetahui informasi selengkapnya, lihat Penyedia dan tujuan peristiwa.
   4. Jenis peristiwa: pilih jenis peristiwa untuk pemicu. Konfigurasi pemicu Anda akan bervariasi berdasarkan penyedia peristiwa yang Anda pilih. Untuk mengetahui informasi selengkapnya, lihat Jenis peristiwa.
   5. Jenis konten data peristiwa: pilih jenis data untuk konten peristiwa. Pilih application/json atau application/protobuf.
   6. Region: pilih region untuk pemicu.
      Tips: Untuk performa optimal dan meminimalkan latensi, pastikan pemicu Eventarc, resource Google Cloud yang dipantau, dan layanan Anda berada di region yang sama. Google Cloud
   7. Akun layanan: pilih akun layanan yang akan digunakan untuk pemicu. Jika Anda tidak memilih akun layanan, pemicu akan menggunakan akun layanan default Compute Engine sebagai identitasnya saat memanggil layanan Anda. Akun layanan yang terkait dengan pemicu harus memiliki izin yang diperlukan untuk memanggil layanan Anda.
   8. Event destination: pilih Application Integration.
   9. Pilih Integrasi: pilih integrasi yang ingin Anda buat pemicunya. Jika integrasi dipublikasikan, Application Integration akan membuat versi draf integrasi baru untuk menambahkan pemicu Eventarc.
   10. Lampiran jaringan: pilih lampiran jaringan yang akan digunakan untuk pemicu. Daftar ini dibuat berdasarkan lampiran jaringan yang dibuat di project Anda.

       Lampiran jaringan memfasilitasi komunikasi antara jaringan Virtual Private Cloud (VPC) jaringan produsen layanan dan jaringan VPC konsumen. Eventarc uses the configured network attachment to establish a connection to an internal HTTP endpoint hosted within the consumer's VPC network, enabling delivery of event data. Untuk mengetahui informasi selengkapnya tentang lampiran jaringan, lihat Tentang lampiran jaringan.

4. Klik Open integration.

   Halaman editor Application Integration akan terbuka dengan integrasi yang dipilih dan elemen Eventarc trigger baru ditambahkan ke integrasi.

5. Klik elemen Eventarc trigger dan buka panel konfigurasi pemicu.
6. Tinjau dan verifikasi konfigurasi pemicu di halaman Eventarc trigger editor.
7. Hubungkan Eventarc trigger baru ke alur integrasi Anda dan publikasikan integrasi.
Catatan: Anda harus memublikasikan integrasi untuk men-deploy dan mengaktifkan pemicu Eventarc. Hingga dipublikasikan, pemicu akan tetap tidak aktif dan tidak akan memproses peristiwa. Untuk mengetahui informasi tentang cara memublikasikan integrasi, lihat Menguji dan memublikasikan integrasi.