Pemicu fungsi Cloud Run

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

Untuk mempelajari cara memicu fungsi di Cloud Run, lihat Pemicu fungsi.

Saat men-deploy atau mengupdate fungsi yang dibuat dengan Cloud Functions API (v2), Anda memiliki akses ke semua kemampuan konfigurasi Cloud Run.

Ada dua cara untuk memicu fungsi:

• Saat membuat fungsi dengan Cloud Functions API (v2), Anda menentukan pemicu sebagai bagian dari deployment fungsi.

• Saat membuat fungsi dengan Cloud Run Admin API, Anda dapat menggunakan Eventarc, Pub/Sub, atau pemicu HTTP lainnya untuk memicu fungsi.

Gunakan halaman ini untuk memahami berbagai jenis pemicu yang dapat Anda konfigurasikan untuk fungsi. Lihat dokumentasi Cloud Run untuk mengetahui daftar lengkap pemicu yang didukung.

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

Jenis pemicu

Anda dapat menyiapkan fungsi untuk dieksekusi sebagai respons terhadap berbagai skenario dengan mengonfigurasi pemicu. Konfigurasikan pemicu HTTP untuk fungsi HTTP dan pemicu peristiwa untuk fungsi CloudEvents.

Pemicu HTTP

Pemicu HTTP bereaksi terhadap permintaan HTTP(S), dan sesuai dengan fungsi HTTP. Untuk mengetahui informasi selengkapnya tentang cara menulis fungsi HTTP, lihat Menulis fungsi HTTP.

Saat Anda membuat fungsi dengan Cloud Functions API (v2), secara default, fungsi tersebut memiliki URL endpoint HTTP cloudfunctions.net. Jika Anda mengambil fungsi ini dan men-deploy-nya di Cloud Run, fungsi Anda juga akan menerima URL run.app. Namun, fungsi yang dibuat di Cloud Run tidak akan memiliki URL endpoint HTTP cloudfunctions.net. URL cloudfunctions.net dan URL run.app dari fungsi akan berperilaku sama persis. Keduanya dapat dipertukarkan, dan digunakan untuk memicu fungsi Anda.

Untuk informasi selengkapnya tentang cara memanggil fungsi dengan pemicu HTTP, lihat Memanggil dengan Permintaan HTTPS.

Pemicu peristiwa

Pemicu peristiwa bereaksi terhadap peristiwa dalam project Google Cloud Anda, dan sesuai dengan fungsi yang dipicu peristiwa (juga dikenal sebagai fungsi CloudEvents). Untuk mengetahui informasi selengkapnya tentang cara menulis fungsi berbasis peristiwa, lihat artikel Menulis fungsi CloudEvents. Untuk informasi selengkapnya tentang cara memanggil fungsi sebagai respons terhadap pemicu peristiwa, lihat Membuat pemicu dengan Eventarc.

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

Bagian ini menjelaskan beberapa contoh pemicu peristiwa yang didukung fungsi Cloud Run.

Pemicu Pub/Sub

Anda dapat memicu fungsi sebagai respons terhadap pesan Pub/Sub menggunakan Eventarc. Saat menentukan pemicu Pub/Sub untuk fungsi, Anda juga menentukan topik Pub/Sub. Sebagai hasil dari pemicu ini, fungsi Anda akan dipanggil setiap kali Anda memublikasikan pesan ke topik yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat Pemicu Pub/Sub.

Anda juga dapat menggunakan Cloud Logging untuk merutekan log ke topik Pub/Sub, agar dapat digunakan oleh fungsi Cloud Run. Untuk mengetahui informasi selengkapnya, lihat Memicu fungsi dari entri log.

Pemicu Cloud Storage

Anda dapat memicu fungsi dari Cloud Storage menggunakan Eventarc, sebagai respons terhadap perubahan di Cloud Storage. Saat menentukan pemicu Cloud Storage untuk suatu fungsi, Anda memilih jenis peristiwa dan menentukan bucket Cloud Storage. Sebagai akibat dari pemicu ini, fungsi Anda akan dipanggil setiap kali terjadi perubahan pada objek (file) dalam bucket yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat Pemicu Cloud Storage.

Pemicu Firestore

Anda dapat mengonfigurasi fungsi Cloud Run agar dipicu oleh peristiwa di database Firestore. Saat dipicu, fungsi Anda akan membaca dan mengupdate database Firestore sebagai respons terhadap peristiwa ini melalui API Firestore dan library klien. Untuk informasi selengkapnya, lihat Pemicu Firestore.

Pemicu peristiwa lainnya

Fungsi Cloud Run mendukung semua jenis peristiwa yang didukung oleh Eventarc, termasuk lebih dari 90 sumber peristiwa melalui Cloud Audit Logs.

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 Scheduler

Anda dapat memicu fungsi dengan pemicu HTTP atau pemicu peristiwa.

Untuk menjadwalkan fungsi Cloud Run HTTP, buat tugas Cloud Scheduler yang memicu tindakan menggunakan HTTP. Anda juga dapat menjadwalkan fungsi berbasis peristiwa yang dipicu secara langsung sebagai respons terhadap peristiwa dalam project Google Cloud Anda; misalnya, saat pesan dipublikasikan ke topik Pub/Sub.

Untuk mengetahui informasi selengkapnya, lihat Tentang Cloud Scheduler.

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.