Pemicu Pub/Sub (generasi ke-1)

Di Cloud 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, pemicu harus diimplementasikan sebagai fungsi berbasis peristiwa:

Repositori Google Events berisi sumber daya tambahan untuk bekerja dengan data peristiwa.

Deployment

Anda dapat menentukan pemicu Pub/Sub saat men-deploy fungsi. Lihat Men-deploy Cloud Function 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 \
--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 Functions (generasi ke-1) menggunakan jenis peristiwa yang berbeda untuk pemicu Pub/Sub:

gcloud functions deploy YOUR_FUNCTION_NAME \
--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 dihapus pada tanggal yang akan datang.

Konsol

Jika melakukan deployment menggunakan Google Cloud Console, Anda dapat mengonfigurasi pemicu Pub/Sub di bagian Pemicu:

  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 untuk membuka jendela guna membuat topik baru. Saat pesan dipublikasikan ke topik fungsi Anda, tindakan 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 otomatis dicoba lagi. Lihat Mencoba kembali fungsi berbasis peristiwa untuk mengetahui informasi selengkapnya.

Langkah berikutnya