Pemicu Eventarc

Di Cloud Functions (generasi ke-2), pemicu Eventarc memungkinkan fungsi dipicu oleh jenis peristiwa apa pun yang didukung oleh Eventarc. Saat menentukan pemicu Eventarc untuk suatu fungsi, Anda menyediakan filter peristiwa. Fungsi Anda akan dipanggil setiap kali ada peristiwa yang cocok dengan filter.

Semua fungsi berbasis peristiwa di Cloud Functions (generasi ke-2) menggunakan pemicu Eventarc. Untuk informasi selengkapnya, lihat Pemicu Eventarc dalam dokumentasi Eventarc. Untuk daftar jenis peristiwa yang didukung, lihat Jenis peristiwa yang didukung oleh Eventarc.

Agar fungsi menggunakan pemicu Eventarc, pemicu harus diimplementasikan sebagai fungsi CloudEvent. Data peristiwa diteruskan ke fungsi Anda dalam format CloudEvents, dengan payload data CloudEvent yang sesuai dengan jenis peristiwa. Repositori Google Events berisi resource tambahan untuk menangani data peristiwa.

Lokasi pemicu

Pemicu Eventarc ditautkan ke lokasi tertentu. Secara umum, lokasi pemicu Eventarc harus cocok dengan lokasi resource Google Cloud yang ingin Anda pantau peristiwanya. Dalam sebagian besar skenario, Anda juga harus men-deploy Cloud Function di region yang sama. Lihat Memahami lokasi Eventarc untuk detail selengkapnya tentang lokasi pemicu Eventarc.

Identitas pemicu

Pemicu Eventarc ditautkan ke akun layanan untuk digunakan sebagai identitas saat memanggil fungsi Anda. Akun layanan pemicu Eventarc harus memiliki izin untuk memanggil fungsi Anda. Secara default, Akun layanan komputasi default akan digunakan.

Deployment

Anda dapat menentukan pemicu Eventarc saat men-deploy fungsi. Lihat Men-deploy Cloud Function untuk petunjuk umum tentang cara men-deploy fungsi. Bagian ini menjelaskan cara mengonfigurasi pemicu Eventarc yang memanggil fungsi saat peristiwa yang cocok dengan filter terjadi selama deployment.

gcloud

Jika Anda melakukan deployment menggunakan gcloud CLI, flag yang ditampilkan akan digunakan untuk mengonfigurasi pemicu Eventarc:

gcloud functions deploy YOUR_FUNCTION_NAME \
  --gen2 \
  --trigger-event-filters="type=EVENTARC_FILTER_TYPE" \
  [--trigger-event-filters=EVENTARC_EVENT_FILTER] \
  [--trigger-event-filters-path-pattern=EVENTARC_EVENT_PATH_PATTERN] \
  [--trigger-location=EVENTARC_TRIGGER_LOCATION] \
  [--trigger-service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT] \
  [--retry] \
...
  • Flag --gen2 menentukan bahwa Anda akan men-deploy ke Cloud Functions (generasi ke-2). Anda harus menggunakan Cloud Functions (generasi ke-2) untuk menggunakan pemicu Eventarc.

  • Flag --trigger-event-filters menentukan filter peristiwa yang akan dipantau pemicu. Peristiwa yang cocok dengan semua filter akan memicu panggilan ke fungsi Anda.

    • Wajib: Setiap pemicu harus memiliki jenis peristiwa yang didukung dalam bentuk --event-filters="type=EVENTARC_FILTER_TYPE". Jenis acara ini tidak dapat diubah setelah dibuat. Untuk mengubah EVENT_FILTER_TYPE, buat pemicu baru dan hapus pemicu lama.
    • Opsional: Anda dapat mengulangi flag --trigger-event-filters dengan filter yang didukung dalam bentuk ATTRIBUTE=VALUE untuk menambahkan filter lainnya.

  • Flag --trigger-event-filters-path-pattern menentukan filter peristiwa yang akan dipantau oleh pemicu dalam format pola jalur. Filter harus dalam format ATTRIBUTE=VALUE. Lihat Memahami pola jalur untuk mengetahui informasi selengkapnya.

  • Flag --trigger-location menentukan lokasi untuk pemicu Eventarc. Lihat Lokasi pemicu untuk mengetahui informasi selengkapnya. Jika tidak ditentukan, region fungsi Anda akan digunakan sebagai lokasi pemicu.

  • Flag --trigger-service-account menentukan akun layanan yang akan digunakan sebagai identitas untuk pemicu Eventarc. Lihat Identitas pemicu untuk mengetahui informasi selengkapnya.

  • Flag --retry mengontrol apakah panggilan fungsi yang gagal akan dicoba ulang secara otomatis. Lihat Mencoba kembali fungsi berbasis peristiwa untuk mengetahui informasi selengkapnya.

Jika Anda membuat pemicu untuk peristiwa Pub/Sub atau Cloud Storage langsung, lihat petunjuk gcloud CLI untuk mengonfigurasi pemicu Pub/Sub dan Cloud Storage.

Dokumentasi Eventarc berisi contoh penentuan filter peristiwa untuk berbagai jenis peristiwa. Untuk informasi selengkapnya, ikuti petunjuk saat membuat pemicu untuk penyedia, jenis peristiwa, dan tujuan tertentu.

Konsol

Jika men-deploy menggunakan konsol Google Cloud, Anda harus memilih generasi ke-2 sebagai lingkungan Anda. Selanjutnya, Anda dapat mengonfigurasi pemicu Eventarc di bagian Pemicu.

  1. Untuk menambahkan pemicu peristiwa, klik Tambahkan pemicu. Tindakan ini akan menampilkan opsi berikut:

    • Pemicu Pub/Sub
    • Pemicu Cloud Storage
    • Pemicu Firestore
    • Pemicu lainnya

    Saat Anda memilih salah satu opsi ini, panel pemicu Eventarc akan terbuka, tempat Anda dapat menentukan detail pemicu.

    Jika Anda membuat pemicu untuk peristiwa Pub/Sub atau Cloud Storage langsung, lihat petunjuk konsol Google Cloud untuk mengonfigurasi pemicu Pub/Sub dan Cloud Storage.

  2. Jika Anda memilih Pemicu lainnya, gunakan kolom Jenis pemicu di Pemicu Eventarc untuk menentukan salah satu Sumber Google, Kustom, atau Pihak ketiga.

    • Dengan Sumber Google, Anda dapat menentukan pemicu untuk Pub/Sub, Cloud Storage, Firestore, dan penyedia peristiwa Google lainnya. Di panel Eventarc trigger, gunakan kolom Event provider untuk memilih produk yang menyediakan jenis peristiwa yang Anda inginkan untuk memicu fungsi. Kemudian, di kolom Peristiwa, pilih peristiwa yang ingin Anda gunakan sebagai pemicu.

    • Opsi Kustom memungkinkan Anda membuat dan menggunakan peristiwa dari kode aplikasi. Ikuti petunjuk di panel Pemicu Eventarc untuk membuat saluran. Saluran adalah resource yang digunakan sebagai pipeline untuk menayangkan peristiwa kustom dari produsen ke konsumen. Peristiwa kustom dipublikasikan ke saluran dan pemicu Eventarc berlangganan ke peristiwa tersebut.

    • Opsi Pihak ketiga memungkinkan Anda berintegrasi dengan penyedia non-Google yang menawarkan sumber Eventarc. Lihat peristiwa pihak ketiga di Eventarc untuk mengetahui detailnya.

  3. Di kolom Region, pilih lokasi untuk pemicu Eventarc, jika ada. Lihat Lokasi pemicu untuk mengetahui informasi selengkapnya.

  4. Secara opsional, di kolom Akun layanan, pilih akun layanan yang akan digunakan sebagai identitas pemicu Eventarc. Lihat Identitas pemicu untuk mengetahui informasi selengkapnya.

  5. Centang atau hapus centang pada kotak Coba lagi saat gagal untuk mengontrol apakah panggilan fungsi yang gagal akan dicoba ulang secara otomatis. Lihat Mencoba kembali fungsi berbasis peristiwa untuk mengetahui informasi selengkapnya.

  6. Klik Simpan pemicu.

Langkah berikutnya