Menyiapkan lingkungan

Sebelum menjadwalkan dan menjalankan cron job, Anda harus menyiapkan Google Cloud project dan lingkungan untuk Cloud Scheduler.

Aktifkan Cloud Scheduler API

Gunakan petunjuk berikut untuk membuat atau memilih Google Cloud project dan untuk mengaktifkan Cloud Scheduler API.

Konsol

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Scheduler API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

gcloud

  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. Instal Google Cloud CLI.

  3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  5. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  6. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan Cloud Scheduler API, jika belum diaktifkan:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable cloudscheduler.googleapis.com

  8. Instal Google Cloud CLI.

  9. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  10. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

    gcloud init

  11. Buat atau pilih Google Cloud project.

    Peran yang diperlukan untuk memilih atau membuat project

    • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
    • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

    • Buat Google Cloud project:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

    • Pilih project Google Cloud yang Anda buat:

      gcloud config set project PROJECT_ID

      Ganti PROJECT_ID dengan nama project Google Cloud Anda.

  12. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

  13. Aktifkan Cloud Scheduler API, jika belum diaktifkan:

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran. 

    gcloud services enable cloudscheduler.googleapis.com
    14.

Menyiapkan autentikasi

Cara Anda melakukan autentikasi ke Cloud Scheduler bergantung pada antarmuka yang Anda gunakan untuk mengakses API dan lingkungan tempat kode Anda dijalankan.

Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi ke Cloud Scheduler dan Menggunakan autentikasi dengan target HTTP.

Menambahkan aplikasi App Engine

Jika akan menggunakan target HTTP App Engine, Anda harus menambahkan aplikasi App Engine ke project Anda. Aplikasi ini berfungsi sebagai lokasi layanan Cloud Scheduler dan handler tugas itu sendiri, yang melakukan pekerjaan yang terkait dengan tugas Cloud Scheduler, dan menampilkan konfirmasi sebagai respons.

Jika ingin memiliki pengendali tugas App Engine yang tidak ada di project, Anda harus memilih target HTTP. Dalam hal ini, Anda tidak memerlukan aplikasi App Engine di project Anda.

Konsol

  1. Di konsol Google Cloud , buka halaman App Engine.

    Buka App Engine

  2. Pada dialog Welcome to App Engine, lakukan salah satu hal berikut:

    • Jika Anda telah membuat aplikasi App Engine dan ada pesan Aplikasi App Engine Anda telah dibuat yang ditampilkan, Anda dapat melewati langkah-langkah yang tersisa di bagian ini.

      atau

    • Jika Anda belum membuat aplikasi App Engine, klik Create application dan lanjutkan dengan langkah-langkah yang tersisa di bagian ini.

  3. Pilih region untuk aplikasi Anda.

    Perhatikan bahwa europe-west dan us-central masing-masing dipanggil sebagai europe-west1 dan us-central1 dalam perintah Cloud Scheduler.

    Setelah menetapkan region untuk aplikasi App Engine, Anda tidak dapat mengubahnya.

  4. Jangan memilih akun layanan; akun layanan App Engine default akan digunakan.

  5. Klik Berikutnya.

    Aplikasi dikonfigurasi dan dibuat. Proses ini dapat memakan waktu beberapa menit.

  6. Jangan download Cloud SDK; sebagai gantinya, klik I'll do this later.

    Anda akan melihat pesan Your App Engine application has been created.

gcloud

  1. Untuk membuat aplikasi App Engine, jalankan perintah gcloud app create:

    gcloud app create --region=REGION

    Ganti REGION dengan lokasi tempat aplikasi berjalan. Perhatikan bahwa europe-west dan us-central masing-masing disebut europe-west1 dan us-central1 dalam perintah Cloud Scheduler.

    Setelah menetapkan region untuk aplikasi App Engine, Anda tidak dapat mengubahnya.

  2. Anda dapat memeriksa region aplikasi yang ada dengan perintah berikut:

    gcloud app describe

    locationId menunjukkan wilayah. Contoh: locationId: us-central.