Menjadwalkan fungsi Cloud Run berbasis peristiwa

---

Tutorial ini menunjukkan cara memicu fungsi Cloud Run berbasis peristiwa menggunakan Cloud Scheduler dan dengan menargetkan topik Pub/Sub. Gunakan fungsi berbasis peristiwa jika fungsi Anda harus dipicu secara langsung sebagai respons terhadap peristiwa dalam project Google Cloud, seperti pesan tentang topik Pub/Sub atau perubahan dalam bucket Cloud Storage.

Perhatikan bahwa Anda juga dapat menjadwalkan fungsi HTTP dengan menargetkan endpoint HTTP fungsi Anda. Gunakan fungsi HTTP jika Anda ingin fungsi memiliki endpoint URL dan merespons permintaan HTTP, seperti untuk webhook. Untuk mengetahui informasi selengkapnya, lihat Jenis fungsi Cloud Run.

Menjadwalkan eksekusi fungsi Cloud Run adalah kasus penggunaan umum untuk Cloud Scheduler. Dalam tutorial ini, Anda akan:

1. Buat fungsi Cloud Run sederhana yang berlangganan topik Pub/Sub.
2. Buat tugas Cloud Scheduler yang memublikasikan pesan ke topik Pub/Sub.
3. Jalankan tugas Cloud Scheduler.
4. Pastikan fungsi Cloud Run dipicu oleh tugas Cloud Scheduler.

Biaya

Dalam dokumen ini, Anda akan menggunakan komponen Google Cloud yang dapat ditagih berikut:

• Cloud Run functions
• Cloud Scheduler
• Pub/Sub

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga. Pengguna baru Google Cloud mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Sebelum memulai

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

   Enable the APIs

5. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Make sure that billing is enabled for your Google Cloud project.

8. Enable the Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler, Eventarc APIs.

   Enable the APIs

9. Create a service account:

   1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
   2. Select your project.

   3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

   4. Click Create and continue.

   5. Grant the Cloud Run > Cloud Run Invoker role to the service account.

      To grant the role, find the Select a role list, then select Cloud Run > Cloud Run Invoker.

      Note: The Role field affects which resources the service account can access in your project. You can revoke these roles or grant additional roles later.
   6. Click Continue.

   7. Click Done to finish creating the service account.

Perhatikan bahwa Anda harus memberikan peran Cloud Run Invoker karena di fungsi Cloud Run (generasi ke-2), izin pemanggilan tersedia dengan mengelola layanan Cloud Run yang mendasarinya.

10. Secara default, fungsi Cloud Run menggunakan akun layanan Compute Engine default yang dibuat secara otomatis untuk akun layanan runtime-nya. Anda dapat menggunakan akun layanan ini untuk mencoba tutorial ini. Namun, bergantung pada konfigurasi kebijakan organisasi Anda, akun layanan default mungkin tidak otomatis diberi peran Editor di project Anda. Jika demikian, Anda harus memberikan peran berikut ke akun layanan:
    1. Penulis Artifact Registry (roles/artifactregistry.writer)
    2. Logs Writer (roles/logging.logWriter)
    3. Storage Object Viewer (roles/storage.objectViewer)

Membuat fungsi Cloud Run berbasis peristiwa

Buat fungsi berbasis peristiwa yang dipicu secara langsung sebagai respons terhadap peristiwa dalam project Google Cloud Anda; dalam hal ini, pesan yang dipublikasikan ke topik Pub/Sub.

1. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

2. Klik Create function.

3. Di bagian Dasar-Dasar, lakukan hal berikut:

   1. Di daftar Environment, pilih 2nd gen.
   2. Masukkan nama untuk fungsi Anda.
   3. Di daftar Region, pilih region.

4. Di bagian Trigger, lakukan tindakan berikut:

   1. Dalam daftar Trigger type, pilih Cloud Pub/Sub.
   2. Di daftar Cloud Pub/Sub topic, pilih topik yang ada atau untuk membuat topik baru, klik Create a topic. Catat nama topik karena Anda akan membutuhkannya di langkah berikutnya.

   3. Klik Opsi lainnya.

      Panel Pemicu Eventarc akan terbuka.

5. Di panel Pemicu Eventarc, lakukan hal berikut:

   1. Jika Anda diminta untuk mengizinkan layanan Pub/Sub membuat token identitas yang diperlukan untuk memanggil fungsi, klik Berikan.
   2. Dalam daftar Service account, pilih akun layanan yang Anda buat sebelumnya.
   3. Terima setelan default lainnya.

   4. Klik Save trigger.

      Panel Pemicu Eventarc akan ditutup.

6. Terima setelan default lainnya, lalu klik Next.

7. Jangan ubah bahasa runtime default dan kode contoh. Kode ini tidak menggunakan layanan cloud apa pun dan tidak memerlukan izin tambahan yang diaktifkan. Klik Deploy.

Buat tugas Cloud Scheduler

Buat tugas Cloud Scheduler dengan target Pub/Sub.

1. Di konsol Google Cloud, buka halaman Cloud Scheduler.

   Buka Cloud Scheduler

2. Klik Create job.

3. Masukkan nama untuk tugas Anda.

4. Di daftar Region, pilih region.

5. Tentukan frekuensi untuk tugas Anda, menggunakan format unix-cron:

   30 16 * * 7
   

   Untuk mengetahui informasi selengkapnya, lihat Format tugas Cron dan zona waktu.

6. Di daftar Zona waktu, pilih zona waktu.

7. Klik Lanjutkan.

8. Dalam daftar Target type, pilih Pub/Sub.

9. Pilih topik Pub/Sub yang Anda buat sebelumnya.

10. Di kolom Message body, masukkan string yang akan dikirim ke topik target Pub/Sub Anda. Misalnya: "Halo dunia!"

11. Klik Create.

Anda telah membuat tugas cron yang mengirim pesan ke topik Pub/Sub Anda pada pukul 16.30 pada hari Minggu. Fungsi Cloud Run Anda berlangganan topik tersebut.

Menjalankan tugas Cloud Scheduler

Sekarang Anda dapat menjalankan tugas yang dibuat.

1. Di konsol Google Cloud, buka halaman Cloud Scheduler.

   Buka Cloud Scheduler

2. Centang kotak untuk tugas yang Anda buat, lalu klik Paksa jalankan.

   Saat pertama kali dipanggil, tugas pertama yang dibuat dalam project dapat memerlukan waktu beberapa menit untuk dikonfigurasi dan dijalankan.

3. Setelah tugas berjalan, Status eksekusi terakhir akan menunjukkan Success.

Memverifikasi hasil di fungsi Cloud Run

Anda dapat memverifikasi bahwa fungsi Cloud Run berhasil dipicu dan dijalankan oleh tugas cron.

1. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

2. Klik nama fungsi.

   Halaman Detail fungsi akan terbuka dan grafik Pemanggilan/Detik akan menampilkan pemanggilan pertama fungsi Anda.

3. Klik tab Logs.

   Anda akan melihat entri log yang mirip dengan Hello, YOUR_STRING!

Pembersihan

Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.

Hapus project

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Menghapus resource tutorial

1. Di konsol Google Cloud, buka halaman Cloud Scheduler.

   Buka Cloud Scheduler

2. Centang kotak di samping pekerjaan Anda.

3. Klik Hapus dan konfirmasi penghapusan.

4. Di konsol Google Cloud, buka halaman Pub/Sub.

   Buka Pub/Sub

5. Centang kotak di samping topik Anda.

6. Klik Hapus dan konfirmasi penghapusan.

7. Di konsol Google Cloud, buka halaman Cloud Run functions.

   Buka fungsi Cloud Run

8. Pilih kotak centang di samping fungsi Anda.

9. Klik Hapus dan konfirmasi penghapusan.

10. Di konsol Google Cloud, buka halaman Akun Layanan.

    Buka Akun Layanan

11. Centang kotak di samping akun layanan yang Anda buat.

12. Klik Hapus dan konfirmasi penghapusan.

Langkah selanjutnya

• Menggunakan Cloud Scheduler untuk memicu Cloud Run sesuai jadwal