Menjadwalkan fungsi HTTP Cloud Run

---

Tutorial ini menunjukkan cara memicu fungsi HTTP Cloud Run menggunakan Cloud Scheduler dan dengan menargetkan endpoint HTTP. Gunakan fungsi HTTP saat fungsi Anda perlu memiliki endpoint URL dan merespons permintaan HTTP, seperti halnya webhook.

Perhatikan bahwa Anda juga dapat menjadwalkan fungsi berbasis peristiwa saat Anda fungsi harus dipicu langsung sebagai respons terhadap peristiwa dalam Project Google Cloud, seperti pesan tentang topik Pub/Sub atau perubahan bucket Cloud Storage. Untuk informasi selengkapnya, lihat Jenis fungsi Cloud Run.

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

1. Membuat fungsi HTTP Cloud Run sederhana.
2. Buat tugas Cloud Scheduler.
3. Jalankan tugas Cloud Scheduler.
4. Pastikan bahwa fungsi Cloud Run dipicu oleh Cloud Scheduler.

Biaya

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

• Cloud Run functions
• Cloud Scheduler

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. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan API Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler.

   Mengaktifkan API

5. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

   3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

   4. Klik Buat dan lanjutkan.

   5. Berikan peran Cloud Run > Cloud Run Invoker ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Cloud Run > Cloud Run Invoker.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

6. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

7. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

8. Aktifkan API Cloud Build, Cloud Functions, Cloud Run Admin, Cloud Scheduler.

   Mengaktifkan API

9. Buat akun layanan:

   1. Di konsol Google Cloud, buka halaman Buat akun layanan.

      Buka Create service account
   2. Pilih project Anda.

   3. Di kolom Nama akun layanan, masukkan nama. Konsol Google Cloud akan mengisi kolom ID akun layanan berdasarkan nama ini.

      Di kolom Deskripsi akun layanan, masukkan sebuah deskripsi. Sebagai contoh, Service account for quickstart.

   4. Klik Buat dan lanjutkan.

   5. Berikan peran Cloud Run > Cloud Run Invoker ke akun layanan.

      Untuk memberikan peran, temukan daftar Pilih peran, lalu pilih Cloud Run > Cloud Run Invoker.

      Catatan: Kolom Peran memengaruhi resource mana yang dapat diakses oleh akun layanan di project Anda. Anda dapat mencabut peran ini atau memberikan peran tambahan di lain waktu. Dalam lingkungan produksi, jangan berikan peran Owner, Editor, atau Viewer. Sebagai gantinya, berikan peran standar atau peran khusus yang memenuhi kebutuhan Anda.
   6. Klik Lanjutkan.

   7. Klik Selesai untuk menyelesaikan pembuatan akun layanan.

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

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

Membuat fungsi HTTP Cloud Run

Membuat fungsi HTTP yang dipicu oleh Cloud Scheduler.

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

   Buka fungsi Cloud Run

2. Klik Buat fungsi.

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

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

4. Di bagian Pemicu, lakukan hal berikut:

   1. Dalam daftar Jenis pemicu, pilih HTTPS.

   2. Untuk autentikasi, pilih Wajibkan autentikasi.

      Untuk informasi selengkapnya, lihat Autentikasi untuk pemanggilan (generasi ke-2).

5. Terima setelan default lainnya, lalu klik Next.

6. Jangan ubah bahasa runtime default dan kode contoh. Kode melakukan tidak menggunakan layanan {i>cloud<i} apa pun dan tidak perlu mengaktifkan izin tambahan. Klik Deploy.

7. Setelah fungsi berhasil di-deploy, klik tab Trigger.

8. Salin URL HTTP untuk fungsi.

Buat tugas Cloud Scheduler

Membuat tugas Cloud Scheduler yang memicu tindakan menggunakan HTTP.

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

   Buka Cloud Scheduler

2. Klik Klik Buat tugas.

3. Masukkan nama untuk pekerjaan Anda.

4. Dalam daftar Region, pilih region.

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

   30 16 * * 7
   

   Untuk informasi selengkapnya, lihat Format tugas dan zona waktu cron.

6. Dalam daftar Zona Waktu, pilih zona waktu.

7. Klik Lanjutkan.

8. Dalam daftar Target type, pilih HTTP.

9. Di kolom URL, masukkan URL HTTP fungsi yang sebelumnya Anda disalin.

10. Di daftar Auth header, pilih Add OIDC token.

11. Dalam daftar Service account, pilih akun layanan yang sebelumnya dibuat.

12. Di kolom Audience, masukkan URL HTTP fungsi yang sebelumnya disalin.

13. Klik Create.

Anda telah membuat cron job yang menjalankan fungsi Cloud Run pada pukul 16.30 pada Minggu.

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 Force run.

   Saat pertama kali dipanggil, tugas pertama yang dibuat dalam proyek dapat mengambil beberapa menit untuk mengkonfigurasi dan menjalankannya.

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

Memverifikasi hasilnya di fungsi Cloud Run

Anda dapat memverifikasi bahwa fungsi Cloud Run berhasil dipicu dan dieksekusi oleh cron job Anda.

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 Invocations/Second menunjukkan pemanggilan pertama fungsi tersebut.

3. Klik tab Logs.

   Anda akan melihat entri log yang mirip dengan POST 200 146 B 5 ms Google-Cloud-Scheduler https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

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 berbagai arsitektur, tutorial, atau panduan memulai, menggunakan kembali project dapat membantu agar Anda tidak melampaui batas kuota project.

1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus 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 Cloud Run functions.

   Buka fungsi Cloud Run

5. Pilih kotak centang di samping fungsi Anda.

6. Klik Hapus dan konfirmasi penghapusan.

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

   Buka Akun Layanan

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

9. Klik Hapus dan konfirmasi penghapusan.

Langkah selanjutnya

• Menggunakan Cloud Scheduler untuk memicu Cloud Run sesuai jadwal