Memicu alur kerja dengan peristiwa atau pesan Pub/Sub

Anda dapat menggunakan pemicu Eventarc untuk menjalankan alur kerja sebagai hasil dari peristiwa atau serangkaian peristiwa. Peristiwa dirutekan dari penyedia peristiwa ke penerima peristiwa yang tertarik.

Eventarc mengirimkan peristiwa ke penerima peristiwa dalam format CloudEvents melalui permintaan HTTP. Layanan Workflows mengonversi peristiwa menjadi objek JSON (mengikuti spesifikasi CloudEvents) dan meneruskan peristiwa ke dalam eksekusi alur kerja sebagai argumen runtime alur kerja.

Eksekusi alur kerja Anda dipicu:

  • Saat log audit dibuat yang cocok dengan kriteria filter pemicu. Misalnya, lihat panduan memulai ini yang memicu Workflows dengan peristiwa dari BigQuery menggunakan Cloud Audit Logs.
  • Sebagai respons terhadap peristiwa langsung seperti update pada bucket Cloud Storage atau update pada template Firebase Remote Config. Misalnya, lihat panduan memulai ini yang memicu Workflows dengan peristiwa langsung dari Cloud Storage.
  • Dengan pesan yang dipublikasikan ke topik Pub/Sub. Misalnya, lihat panduan memulai ini yang memicu Workflows dengan pesan Pub/Sub.

Perhatikan hal berikut:

  • Peristiwa dianggap terkirim segera setelah eksekusi alur kerja dimulai, dan eksekusi sebenarnya terjadi secara asinkron di layanan Workflows.

  • Eksekusi yang dipicu oleh peristiwa tidak akan dicoba lagi jika eksekusi alur kerja dimulai, tetapi kemudian gagal. Untuk mengetahui informasi selengkapnya, lihat Kebijakan percobaan ulang peristiwa.

  • Periode penghapusan duplikat Workflows untuk memastikan pemrosesan peristiwa yang tepat adalah 24 jam.

  • Saat menggunakan Workflows sebagai tujuan untuk pemicu Eventarc, peristiwa yang lebih besar dari ukuran argumen Workflows maksimum akan gagal memicu eksekusi alur kerja. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.

  • Di project yang dilindungi oleh perimeter layanan, saat merutekan peristiwa ke tujuan Workflows yang endpoint push Pub/Sub-nya ditetapkan ke eksekusi Workflows, Anda hanya dapat membuat langganan push Pub/Sub baru melalui Eventarc. Perhatikan bahwa akun layanan yang digunakan untuk autentikasi push untuk endpoint Workflows harus disertakan dalam perimeter layanan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan perimeter layanan menggunakan Kontrol Layanan VPC.

Membuat pemicu menggunakan Google Cloud CLI

Anda dapat membuat pemicu dengan menjalankan perintah gcloud eventarc triggers create beserta flag wajib dan opsional.

Untuk mengetahui informasi selengkapnya, lihat petunjuk gcloud di bagian "Membuat pemicu" saat membuat pemicu untuk penyedia, jenis peristiwa, dan tujuan Workflows tertentu.

Membuat pemicu menggunakan konsol

Langkah-langkah berikut menunjukkan cara membuat pemicu di halaman Workflows di Google Cloud konsol.

Sebelum memulai

  1. Aktifkan Eventarc 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

  2. Buat akun layanan agar Eventarc dapat membuat permintaan ke Workflows API:

    1. Di Google Cloud konsol, buka halaman Akun Layanan.

      Buka Akun Layanan

    2. Pilih project, lalu klik Buat akun layanan.

    3. Di kolom Nama akun layanan, masukkan nama yang terdiri dari 6 hingga 30 karakter.

      Nama tersebut dapat berisi karakter alfanumerik huruf kecil dan tanda hubung. Setelah membuat akun layanan, Anda tidak dapat mengubah namanya.

    4. Klik Buat dan lanjutkan.

    5. Beri akun layanan baru Anda peran workflows.invoker agar akun tersebut memiliki izin untuk memicu alur kerja Anda. Dalam daftar Pilih peran, pilih Workflows > Workflows Invoker.

      Jika Anda mengembangkan aplikasi produksi, selalu berikan peran yang paling tidak permisif. Untuk mengetahui informasi selengkapnya, lihat Mengelola akses ke project, folder, dan organisasi.

    6. Klik Selesai.

  3. Untuk mengizinkan akun utama yang akan menjalankan perintah Eventarc Anda untuk bertindak sebagai akun layanan Identity and Access Management (IAM) , berikan peran yang memungkinkan akun utama meniru akun layanan.

Mengonfigurasi pemicu

  1. Jika Anda belum memiliki alur kerja yang ingin dipicu, buat dan deploy alur kerja.

  2. Di Google Cloud konsol, buka halaman Workflows:

    Buka Workflows

  3. Di halaman Workflows, pilih alur kerja untuk membuka halaman detailnya.

  4. Di halaman Detail Alur Kerja, klik Edit.

  5. Di halaman Edit alur kerja, pilih Tambahkan pemicu baru > Eventarc.

    Panel Pemicu Eventarc akan terbuka.

  6. Ikuti petunjuk untuk membuat pemicu bagi penyedia, jenis peristiwa, dan Workflows tujuan serta lihat petunjuk Konsol di bagian "Membuat pemicu".

  7. Pilih Akun layanan yang memanggil alur kerja Anda.

    Tindakan ini menentukan akun layanan IAM yang sebelumnya Anda beri peran workflows.invoker sehingga akun tersebut memiliki izin untuk memicu alur kerja Anda.

  8. Klik Save trigger.

    Pemicu Eventarc tercantum di tab Pemicu pada halaman Detail Workflows.

  9. Jika ingin memperbarui atau menghapus pemicu, Anda harus mengedit alur kerja:

    1. Di halaman Detail Alur Kerja, klik Edit.
    2. Di bagian Pemicu, temukan pemicu yang ingin Anda perbarui atau hapus.
    3. Klik Edit resource atau Delete resource.

Eksekusi alur kerja Anda kini dipicu oleh peristiwa yang cocok dengan kriteria filter pemicu Anda.

Membuat pemicu menggunakan Terraform

Anda dapat membuat pemicu untuk alur kerja menggunakan Terraform. Untuk mengetahui detailnya, lihat Memicu alur kerja menggunakan Eventarc dan Terraform.

Langkah berikutnya