Pemicu Pub/Sub (generasi ke-1)

Di Cloud Run Functions, pemicu Pub/Sub memungkinkan suatu fungsi dipanggil sebagai respons terhadap pesan Pub/Sub. Saat menentukan pemicu Pub/Sub untuk suatu fungsi, Anda juga menentukan topik Pub/Sub. Fungsi Anda akan dipanggil setiap kali pesan dipublikasikan ke topik yang ditentukan.

Agar fungsi dapat menggunakan pemicu Pub/Sub, fungsi itu harus diimplementasikan sebagai fungsi berbasis peristiwa:

Repositori Google Events berisi resource tambahan untuk menangani data peristiwa.

Deployment

Anda dapat menentukan pemicu Pub/Sub saat men-deploy fungsi. Lihat Men-deploy fungsi Cloud Run untuk mengetahui petunjuk umum tentang cara men-deploy fungsi, dan lihat bagian ini untuk mengetahui informasi tambahan khusus terkait cara mengonfigurasi pemicu Pub/Sub selama deployment.

gcloud

Jika Anda men-deploy menggunakan gcloud CLI, flag yang ditampilkan di sini digunakan untuk mengonfigurasi pemicu Pub/Sub:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-topic=YOUR_PUBSUB_TOPIC \
[--retry] \
...
  • Flag --trigger-topic menentukan topik Pub/Sub yang akan dipantau oleh pemicu. Pesan yang dipublikasikan ke topik ini akan memicu panggilan ke fungsi Anda.
  • Flag --retry mengontrol apakah panggilan fungsi yang gagal akan dicoba ulang secara otomatis. Lihat Mencoba kembali fungsi berbasis peristiwa untuk mengetahui informasi selengkapnya.

Peristiwa Pub/Sub lama

Fungsi lama di Cloud Run Functions (generasi ke-1) menggunakan jenis peristiwa yang berbeda untuk pemicu Pub/Sub:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-event=providers/cloud.pubsub/eventTypes/topic.publish \
--trigger-resource=YOUR_PUBSUB_TOPIC \
...

Jenis peristiwa ini didukung untuk fungsi lama yang telah menggunakan peristiwa ini. Namun, sebaiknya gunakan flag --trigger-topic, karena jenis peristiwa yang lama mungkin akan dihapus di kemudian hari.

Konsol

Jika men-deploy menggunakan konsol Google Cloud , Anda dapat mengonfigurasi pemicu Pub/Sub di bagian Trigger:

  1. Di kolom Trigger type, pilih Cloud Pub/Sub.
  2. Di kolom Select a Cloud Pub/Sub topic, pilih topik untuk pemicu yang akan dipantau, atau pilih Create a topic guna membuka jendela untuk membuat topik baru. Saat pesan dipublikasikan ke topik fungsi Anda, hal tersebut akan memicu panggilan ke fungsi Anda.
  3. Centang atau hapus centang pada kotak Retry on failure untuk mengontrol apakah panggilan fungsi yang gagal akan dicoba ulang secara otomatis. Lihat Mencoba kembali fungsi berbasis peristiwa untuk mengetahui informasi selengkapnya.

Langkah berikutnya