Menjadwalkan fungsi HTTP Cloud Run

Tutorial ini menunjukkan cara menjadwalkan fungsi Cloud Run HTTP 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 berbasis peristiwa berdasarkan CloudEvents, gunakan pemicu Eventarc untuk menjadwalkan fungsi Anda agar merespons peristiwa dalam project Anda. Eventarc dapat memicu pesan pada topik Pub/Sub, perubahan dalam bucket Cloud Storage, dan lainnya. Untuk mengetahui informasi selengkapnya, lihat Menulis fungsi Cloud Run.

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

1. Membuat fungsi Cloud Run HTTP.
2. Membuat tugas Cloud Scheduler.
3. Menjalankan tugas Cloud Scheduler.
4. Memverifikasi hasil di fungsi Cloud Run.

Biaya

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

• Cloud Run
• Cloud Scheduler

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

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

Sebelum memulai

Login keakun Anda. Google Cloud 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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.
7. Click Continue.

8. 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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Create a service account:

1. Ensure that you have the Create Service Accounts IAM role (roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles.

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

   Go to Create service account
3. Select your project.

4. 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.

5. Click Create and continue.

6. 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.
7. Click Continue.

8. Click Done to finish creating the service account.

Perhatikan bahwa Anda harus memberikan peran Cloud Run Invoker karena dalam 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)
• Cloud Scheduler Admin (roles/cloudscheduler.admin)
• Logs View Accessor (roles/logging.viewAccessor)
• Project IAM Admin (roles/resourcemanager.projectIamAdmin)
• Admin Akun Layanan (roles/iam.serviceAccountAdmin)
• Pengguna Akun Layanan (roles/iam.serviceAccountUser)

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

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

Catatan: Peran dasar IAM mungkin juga berisi izin untuk menyelesaikan tutorial. Anda tidak boleh memberikan peran dasar dalam lingkungan produksi, tetapi Anda dapat memberikannya dalam lingkungan pengembangan atau pengujian.

Memberikan peran

Konsol

1. Di Google Cloud konsol, buka halaman IAM.

   Buka IAM
2. Pilih project.
3. Klik Grant access.

4. Di kolom New principals, masukkan ID pengguna Anda. ID ini biasanya adalah alamat email yang digunakan untuk men-deploy layanan Cloud Run.

5. Di daftar Select a role, pilih peran.
6. Untuk memberikan peran tambahan, klik Add another role , lalu tambahkan tiap peran tambahan.
7. Klik Save.

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 dengannomor project Anda. Google Cloud
• PROJECT_ID denganID project Anda. Google Cloud
• PRINCIPAL dengan akun yang Anda tambahkan binding-nya. ID ini biasanya adalah alamat email yang digunakan untuk men-deploy layanan Cloud Run.
• ROLE dengan peran yang Anda tambahkan ke akun deployer.

Membuat fungsi Cloud Run HTTP

Buat fungsi HTTP yang dipicu oleh Cloud Scheduler.

1. Di Google Cloud konsol, buka halaman Cloud Run > Services.

   Buka Layanan

2. Klik Write a function.

3. Di bagian Configure, lakukan hal berikut:

   1. Di kolom Service name, masukkan nama untuk fungsi Anda.
   2. Di daftar Region, pilih region.
   3. Jangan ubah bahasa runtime default.

   4. Untuk autentikasi, pilih Require authentication.

      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 Ringkasan autentikasi.

4. Terima nilai default lainnya, lalu klik Create.

5. Salin URL HTTP untuk fungsi tersebut.

Untuk mengetahui informasi selengkapnya, termasuk cara men-deploy fungsi Cloud Run menggunakan Terraform, lihat Men-deploy fungsi Cloud Run.

Membuat tugas Cloud Scheduler

Buat tugas Cloud Scheduler yang memicu tindakan menggunakan HTTP.

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

   Buka Tugas

2. Klik Create job.

3. Masukkan nama untuk tugas Anda.

4. Di daftar Region, pilih region.

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

   30 16 * * 7
   

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

6. Di daftar Timezone, pilih zona waktu.

7. Klik Continue.

8. Di daftar Target type, pilih HTTP.

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

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

11. Di daftar Service account, pilih akun layanan yang sebelumnya Anda buat.

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

13. Klik Create.

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

Menjalankan tugas Cloud Scheduler

Sekarang Anda dapat menjalankan tugas yang Anda buat.

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

   Buka Tugas

2. Pilih kotak centang untuk tugas yang Anda buat.

3. Klik Force run.

   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 harus menunjukkan Success.

Memverifikasi hasil di fungsi Cloud Run

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

1. Di Google Cloud konsol, buka halaman Cloud Run > Services.

   Buka Layanan

2. Untuk memfilter daftar layanan untuk fungsi, pilih filter_list Filter > Deployment type > Function.

3. Klik nama fungsi.

   Halaman Service details akan terbuka dan menampilkan metrik layanan.

4. 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 akan memberikan 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. Di Google Cloud konsol, buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang Anda ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Menghapus resource tutorial

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

   Buka Tugas

2. Pilih kotak centang di samping tugas Anda.

3. Klik Delete dan konfirmasi penghapusan Anda.

4. Di Google Cloud konsol, buka halaman Cloud Run > Services.

   Buka Layanan

5. Pilih kotak centang di samping layanan Anda.

6. Klik Delete dan konfirmasi penghapusan Anda.

7. Di Google Cloud konsol, buka halaman Service Accounts.

   Buka Akun Layanan

8. Pilih kotak centang di samping akun layanan yang Anda buat.

9. Klik Delete dan konfirmasi penghapusan Anda.

Langkah berikutnya

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