Halaman ini diterjemahkan oleh Cloud Translation API.

Menjadwalkan fungsi Cloud Run HTTP

Tutorial ini menunjukkan cara menjadwalkan fungsi HTTP Cloud Run dengan menargetkan endpoint HTTP di Cloud Scheduler. Gunakan fungsi HTTP jika Anda ingin fungsi memiliki endpoint URL dan merespons permintaan HTTP, seperti untuk webhook.

Atau, jika Anda membuat fungsi CloudEvents, gunakan pemicu peristiwa Eventarc untuk menjadwalkan fungsi Anda agar merespons peristiwa dalam project Anda. Eventarc dapat memicu pesan di topik Pub/Sub, perubahan dalam bucket Cloud Storage, dan lainnya. 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:

Biaya

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

Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda, gunakan kalkulator harga.

Pengguna Google Cloud baru mungkin memenuhi syarat untuk mendapatkan uji coba gratis.

Sebelum memulai

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.

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

Go to project selector

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

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

Enable the APIs

Create a service account:

In the Google Cloud console, go to the Create service account page.
Go to Create service account
Select your project.
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.
Click Create and continue.
Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

To grant a role, find the Select a role list, then select the role.

To grant additional roles, click Add another role and add each additional role.

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.
Click Continue.
Click Done to finish creating the service account.

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

Go to project selector

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

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

Enable the APIs

Create a service account:

In the Google Cloud console, go to the Create service account page.
Go to Create service account
Select your project.
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.
Click Create and continue.
Grant the following roles to the service account: Cloud Run > Cloud Run Invoker, Cloud Run > Cloud Run Builder.

To grant a role, find the Select a role list, then select the role.

To grant additional roles, click Add another role and add each additional role.

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.
Click Continue.
Click Done to finish creating the service account.

Perhatikan bahwa Anda harus memberikan peran Cloud Run Invoker karena di fungsi Cloud Run, izin pemanggilan tersedia dengan mengelola layanan Cloud Run yang mendasarinya.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan tutorial, minta administrator Anda untuk memberi Anda peran IAM berikut di project Anda:

Cloud Run Source Developer (roles/run.sourceDeveloper)
Admin Cloud Scheduler (roles/cloudscheduler.admin)
Logs View Accessor (roles/logging.viewAccessor)
Project IAM Admin (roles/resourcemanager.projectIamAdmin)
Service Account Admin (roles/iam.serviceAccountAdmin)
Service Account User (roles/iam.serviceAccountUser)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Memberikan peran

Konsol

Di konsol Google Cloud , buka halaman IAM.
Buka IAM
Pilih project.
Klik Berikan akses.
Di kolom Akun utama baru, masukkan ID pengguna Anda. Ini biasanya berupa alamat email Akun Google yang digunakan untuk men-deploy layanan Cloud Run.
Di daftar Pilih peran, pilih peran.
Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
Klik Simpan.

gcloud

Untuk memberikan peran IAM yang diperlukan ke akun Anda di project Anda:

     gcloud projects add-iam-policy-binding PROJECT_ID \
         --member=PRINCIPAL \
         --role=ROLE

Ganti:

PROJECT_NUMBER dengan Google Cloud project number.
PROJECT_ID dengan Google Cloud project ID Anda.
PRINCIPAL dengan akun yang Anda tambahkan binding-nya. Biasanya, alamat email Akun Google yang digunakan untuk men-deploy layanan Cloud Run.
ROLE dengan peran yang Anda tambahkan ke akun deployer.

Membuat fungsi HTTP Cloud Run

Buat fungsi HTTP yang dipicu oleh Cloud Scheduler.

Di konsol Google Cloud , buka halaman Cloud Run.

Buka Cloud Run
Klik Write a function.
Di bagian Konfigurasi, lakukan hal berikut:
1. Di kolom Nama layanan, masukkan nama untuk fungsi Anda.
2. Di daftar Region, pilih region.
3. Jangan ubah bahasa runtime default.
4. Untuk autentikasi, pilih Wajibkan autentikasi.
  
  Jika Anda dikenai kebijakan organisasi pembatasan domain yang membatasi pemanggilan yang tidak terautentikasi untuk project, Anda perlu mengakses layanan yang di-deploy seperti yang dijelaskan di bagian Menguji layanan pribadi.
  
  Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi untuk pemanggilan.
Setujui default lainnya, lalu klik Create.
Salin URL HTTP untuk fungsi tersebut.

Buat tugas Cloud Scheduler

Buat tugas Cloud Scheduler yang memicu tindakan menggunakan HTTP.

Di konsol Google Cloud , buka halaman Cloud Scheduler.

Buka Cloud Scheduler
Klik Buat tugas.
Masukkan nama untuk tugas Anda.
Di daftar Region, pilih region.
Tentukan frekuensi untuk tugas Anda, menggunakan format unix-cron:
```
30 16 * * 7
```
Untuk mengetahui informasi selengkapnya, lihat Format cron job dan zona waktu.
Di daftar Zona waktu, pilih zona waktu.
Klik Lanjutkan.
Dalam daftar Jenis target, pilih HTTP.
Di kolom URL, masukkan URL HTTP fungsi yang sebelumnya Anda salin.
Dalam daftar Header auth, pilih Tambahkan token OIDC.
Dalam daftar Service account, pilih akun layanan yang Anda buat sebelumnya.
Di kolom Audiens, masukkan URL HTTP fungsi yang sebelumnya Anda salin.
Klik Buat.

Anda telah membuat tugas cron yang menjalankan fungsi Cloud Run pada pukul 16.30 setiap hari Minggu.

Jalankan tugas Cloud Scheduler

Sekarang Anda dapat menjalankan tugas yang Anda buat.

Di konsol Google Cloud , buka halaman Cloud Scheduler.

Buka Cloud Scheduler
Centang kotak untuk tugas yang Anda buat, lalu klik Jalankan paksa.

Saat pertama kali dipanggil, tugas pertama yang dibuat dalam project dapat memerlukan waktu beberapa menit untuk dikonfigurasi dan dijalankan.
Setelah tugas berjalan, Status of last execution akan menunjukkan Success.

Memverifikasi hasil di Cloud Run Functions

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

Di konsol Google Cloud , buka halaman Cloud Run.

Buka Cloud Run
Pilih Filter layanan > Jenis deployment > Function. Tindakan ini memfilter daftar layanan untuk hanya menampilkan fungsi.
Klik nama fungsi.

Halaman Service details akan terbuka dan menampilkan metrik layanan.
Klik tab Logs.

Anda akan melihat entri log yang mirip dengan POST 200 146 B 5 ms Google-Cloud-Scheduler https://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 beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Menghapus resource tutorial

Di konsol Google Cloud , buka halaman Cloud Scheduler.

Buka Cloud Scheduler
Centang kotak di samping tugas Anda.
Klik Hapus, lalu konfirmasi penghapusan Anda.
Di konsol Google Cloud , buka halaman Cloud Run.

Buka Cloud Run
Pilih kotak centang di samping layanan Anda.
Klik Hapus, lalu konfirmasi penghapusan Anda.
Di konsol Google Cloud , buka halaman Service Accounts.

Buka Akun Layanan
Pilih kotak centang di samping akun layanan yang Anda buat.
Klik Hapus, lalu konfirmasi penghapusan Anda.

Langkah berikutnya

Menggunakan Cloud Scheduler untuk memicu Cloud Run sesuai jadwal
Tulis fungsi CloudEvents untuk menjadwalkan fungsi Anda agar merespons peristiwa dalam project Anda.