Pemicu fungsi Cloud Run

Catatan: Konten ini hanya berlaku untuk fungsi Cloud Run—sebelumnya Cloud Functions (generasi ke-2).

Untuk versi generasi ke-1 dokumen ini, lihat Pemicu fungsi Cloud Run (generasi ke-1).

Anda dapat menyiapkan fungsi Cloud Run untuk dieksekusi sebagai respons terhadap berbagai skenario dengan menentukan pemicu untuk fungsi Anda. Pemicu dapat berupa permintaan HTTP(S) atau salah satu dari sejumlah peristiwa yang didukung. Halaman ini memberikan ringkasan tentang pemicu yang didukung oleh fungsi Cloud Run.

Secara umum, pemicu dikelompokkan ke dalam dua kategori:

• Pemicu HTTP, yang bereaksi terhadap permintaan HTTP(S), dan sesuai dengan fungsi HTTP.

• Pemicu peristiwa, yang bereaksi terhadap peristiwa dalam project Google Cloud Anda, dan sesuai dengan fungsi yang dipicu peristiwa.

Anda menentukan pemicu sebagai bagian dari deployment fungsi. Anda tidak dapat mengikat fungsi yang sama ke lebih dari satu pemicu sekaligus, tetapi Anda dapat memiliki peristiwa yang sama yang menyebabkan beberapa fungsi dieksekusi dengan men-deploy beberapa fungsi dengan setelan pemicu yang sama.

Catatan: Pengikatan pemicu tidak terjadi secara instan. Mungkin perlu waktu beberapa menit hingga fungsi yang di-deploy mulai memicu peristiwa masuk.

Pemicu yang didukung

Fungsi Cloud Run mendukung jenis pemicu berikut:

• Pemicu HTTP
• Pemicu peristiwa:
  • Pemicu Pub/Sub
  • Pemicu Cloud Storage
  • Pemicu Firestore
  • Pemicu Eventarc yang digeneralisasi
    • Mendukung semua jenis peristiwa yang didukung oleh Eventarc, termasuk 90+ sumber peristiwa melalui Cloud Audit Logs

Semua fungsi berbasis peristiwa menggunakan Eventarc untuk pengiriman peristiwa. Pemicu Pub/Sub dan pemicu Cloud Storage diimplementasikan sebagai jenis pemicu Eventarc tertentu.

Catatan: Eventarc saat ini tidak mendukung peristiwa langsung dari Google Analytics for Firebase, atau Firebase Authentication.

Pemicu tambahan melalui Pub/Sub dan webhook

Karena fungsi Cloud Run dapat dipicu oleh pesan pada topik Pub/Sub, Anda dapat mengintegrasikan fungsi Cloud Run dengan layanan Google lainnya yang mendukung Pub/Sub sebagai bus peristiwa. Selain itu, dengan menggunakan pemicu HTTP, Anda juga dapat mengintegrasikan dengan layanan apa pun yang menyediakan callback HTTP (webhook). Bagian berikut menjelaskan beberapa contoh integrasi.

Cloud Logging

Cloud Logging dapat merutekan log ke topik Pub/Sub, yang kemudian dapat dipakai oleh fungsi Cloud Run. Lihat Mengonfigurasi dan mengelola sink dalam dokumentasi Cloud Logging untuk mengetahui informasi selengkapnya.

Cloud Scheduler

Anda dapat menjadwalkan fungsi Cloud Run HTTP dengan membuat tugas Cloud Scheduler yang memicu tindakan menggunakan HTTP. Untuk informasi selengkapnya, dalam dokumentasi Cloud Scheduler, lihat Menjadwalkan fungsi Cloud Run HTTP.

Anda dapat menjadwalkan fungsi berbasis peristiwa jika fungsi Anda harus dipicu secara langsung sebagai respons terhadap peristiwa dalam project Google Cloud; misalnya, saat pesan dipublikasikan ke topik Pub/Sub. Untuk mengetahui informasi selengkapnya, dalam dokumentasi Cloud Scheduler, lihat Menjadwalkan fungsi Cloud Run berbasis peristiwa.

Cloud Tasks

Dengan tugas Target HTTP Cloud Tasks, Anda dapat menjalankan pengendali tugas di endpoint HTTP mana pun, sehingga fungsi Cloud Run dengan pemicu HTTP dapat digunakan sebagai pengendali tugas. Anda juga dapat menggunakan tugas untuk men-throttle atau membatasi kapasitas pemanggilan fungsi. Lihat Membuat tugas Target HTTP dalam dokumentasi Cloud Tasks untuk mengetahui informasi selengkapnya.

Gmail

Dengan menggunakan Push Notification API Gmail, Anda dapat mengirim peristiwa Gmail ke topik Pub/Sub dan menggunakannya dengan fungsi Cloud Run.