Menjalankan tugas

Halaman ini menjelaskan cara Cloud Run menjalankan tugasnya. Mengeksekusi tugas membuat eksekusi tugas di mana semua tugas harus dijalankan hingga selesai dengan sukses agar eksekusi tugas berhasil. Eksekusi tugas akan menulis log ke Cloud Logging dan mengirim data pemantauan ke Cloud Monitoring.

Selain fitur logging ini, Anda juga dapat melihat detail eksekusi tugas untuk 1.000 eksekusi tugas terbaru menggunakan panel detail eksekusi, beserta eksekusi yang terjadi dalam tujuh hari terakhir. Detail eksekusi lama dipindahkan dan tidak akan lagi terlihat di panel detail eksekusi. Namun, log dan data pemantauan untuk eksekusi yang lebih lama masih tersedia di Cloud Logging dan Cloud Monitoring, yang tunduk pada kebijakan retensi untuk produk tersebut

Apa itu eksekusi tugas?

Mengeksekusi tugas Cloud Run berarti membuat instance dan menjalankan beban kerja yang dikonfigurasi hingga selesai, yang dibagi menjadi satu atau beberapa tugas paralel atau berurutan, tanpa memproses atau menyalurkan permintaan HTTP.

Entitas inti tugas adalah sebagai berikut:

• Tugas: Konfigurasi statis dan persisten. File ini menentukan image container, alokasi resource (CPU, memori, GPU), variabel lingkungan, dan parameter eksekusi (total tugas, paralelisme, waktu tunggu, dan coba lagi).

• Eksekusi: Peristiwa siklus proses temporal yang dibuat saat Anda memicu tugas. "Eksekusi" mewakili objek pelacakan keseluruhan untuk satu kali menjalankan tugas.

• Tugas: Satu instance container yang dikonfigurasi dan sedang berjalan. Eksekusi terdiri dari satu atau beberapa tugas (taskCount).

Pada dasarnya, ada dua cara berbeda untuk menjalankan tugas:

• Sebagai tugas reguler.

  Saat Anda menjalankan tugas sebagai tugas reguler (default), eksekusi akan dimulai sesegera mungkin.

• Sebagai tugas yang tertunda.

  Saat menjalankan tugas sebagai tugas tertunda, Anda setuju untuk menunda tugas yang tidak mendesak hingga durasi maksimum 12 jam, sebagai imbalan atas harga yang lebih baik.

Meskipun setiap tugas bersifat reguler atau tertunda, Anda dapat mengganti setelan ini untuk satu eksekusi tugas, sehingga tugas reguler dieksekusi sebagai tugas tertunda, atau tugas tertunda dieksekusi sebagai tugas reguler. Lihat Menunda eksekusi tugas untuk mengetahui detailnya.

Tabel berikut memberikan tampilan yang lebih terperinci tentang kemungkinan skenario eksekusi untuk instance tugas tertentu:

Metode Eksekusi	Perintah / Pemicu	Waktu Alokasi Resource	Tingkat Biaya	Penundaan / Waktu Tunggu Maksimum	Kasus Penggunaan Umum
Standard (Sesuai Permintaan)	gcloud run jobs execute	Segera dimulai / SEGERA	Tarif Tugas Standar	Mulai segera; durasi maksimum 7 hari	Pemrosesan data ad-hoc, pemicu manual, pipeline berbasis peristiwa
Buat/Perbarui & Jalankan	gcloud run jobs create/update --execute-now	Segera dimulai setelah dibuat	Tarif Tugas Standar	Mulai segera; durasi maksimum 7 hari	Deployment CI/CD, migrasi skema, pemanasan pasca-deployment
Eksekusi Tertunda	gcloud beta run jobs execute --delay-execution	Dimulai dalam jendela yang dioptimalkan sistem	Tarif Diskon	Penundaan maksimal 12 jam sebelum pembatalan otomatis, waktu tunggu maksimal 12 jam	Tugas batch tidak mendesak, analisis semalam, inferensi AI massal
Eksekusi dengan Penggantian	gcloud run jobs execute --args=... --tasks=...	Segera dimulai / secepatnya	Tarif Tugas Standar	Mulai segera; waktu tunggu diganti	Pengisian ulang khusus partisi, ukuran batch dinamis, menjalankan debug

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk operasi yang dijelaskan di halaman ini, minta administrator Anda untuk memberi Anda salah satu peran IAM berikut di tugas Cloud Run Anda:

• Untuk menjalankan tugas menggunakan Google Cloud CLI: Cloud Run Invoker (roles/run.invoker) pada tugas Cloud Run
• Untuk menjalankan tugas menggunakan konsol Google Cloud , mengganti konfigurasi tugas, atau membatalkan eksekusi tugas: Cloud Run Developer (roles/run.developer) di tugas Cloud Run

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika tugas Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.

Menjalankan tugas

Anda dapat menjalankan tugas menggunakan konsol Google Cloud , Google Cloud CLI, library klien, atau REST API.

Konsol

Untuk menjalankan tugas:

1. Di konsol Google Cloud , buka halaman Tugas Cloud Run:

   Buka tugas Cloud Run

2. Temukan tugas yang Anda minati.

3. Klik tugas untuk menampilkan halaman detail tugas.

4. Klik Jalankan.

gcloud

Untuk menjalankan tugas yang ada:

gcloud run jobs execute JOB_NAME

Jika Anda ingin perintahnya menunggu sampai eksekusi selesai, gunakan

gcloud run jobs execute JOB_NAME --wait --region=REGION

Untuk mengikuti log eksekusi segera setelah meluncurkannya, gunakan:

gcloud beta run jobs execute JOB_NAME --tail --region=REGION

Ganti kode berikut:

• JOB_NAME: nama tugas.
• REGION: region tempat resource dapat ditemukan. Contoh, europe-west1. Atau, tetapkan properti run/region.

Library klien

Untuk menjalankan tugas yang ada dari kode:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Untuk menjalankan tugas yang ada, kirim permintaan HTTP POST ke metode API jobs.run.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME:run

Ganti kode berikut:

• ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk menjalankan tugas. Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
• JOB_NAME: nama tugas.
• REGION: Google Cloud region tugas.
• PROJECT_ID: Google Cloud Project ID

Menjalankan tugas segera

Konsol

Untuk menjalankan tugas segera:

1. Di konsol Google Cloud , buka halaman Tugas Cloud Run:

   Buka tugas Cloud Run

2. Jika Anda memiliki tugas yang ada, klik tugas untuk menampilkan halaman detail tugas, lalu pilih Lihat & edit konfigurasi tugas. Jika Anda membuat tugas baru, pilih Deploy container.

3. Buka bagian bawah halaman dan centang kotak Jalankan tugas segera sebelum membuat atau memperbarui tugas.

gcloud

Anda dapat menentukan tanda --execute-now saat membuat atau memperbarui tugas:

• Membuat tugas:

  gcloud run jobs create JOB_NAME \
    --image IMAGE_URL \
    --execute-now \
    --region=REGION

• Memperbarui tugas:

  gcloud run jobs update JOB_NAME --execute-now --region=REGION

Ganti kode berikut:

• JOB_NAME: nama tugas.
• IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
• REGION: region tempat resource dapat ditemukan. Contoh, europe-west1.

YAML

Anda dapat menyimpan spesifikasi tugas dalam file YAML, lalu men-deploy-nya menggunakan gcloud CLI.

1. Jika Anda membuat tugas baru, lewati langkah ini. Jika Anda memperbarui tugas yang ada, download konfigurasi YAML-nya:

   gcloud run jobs describe JOB_NAME --format export > job.yaml

2. Konfigurasikan atribut startExecutionToken seperti yang ditunjukkan berikut:

   apiVersion: run.googleapis.com/v2
   kind: Job
   metadata:
     name: JOB_NAME
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE_URL
     startExecutionToken: START_EXECUTION_SUFFIX

   Ganti kode berikut:

   • JOB_NAME: nama tugas Cloud Run Anda. Nama tugas harus terdiri dari 49 karakter atau kurang dan harus unik per region dan project.
   • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
   • START_EXECUTION_SUFFIX: string unik yang digunakan sebagai akhiran untuk membuat eksekusi baru. Tugas akan siap saat eksekusi berhasil dimulai. Jumlah panjang nama tugas dan token harus kurang dari 63 karakter.

   Anda juga dapat menentukan konfigurasi lainnya, seperti variabel lingkungan atau batas memori.

3. Buat atau perbarui tugas menggunakan perintah berikut:

   gcloud run jobs replace job.yaml

   Perintah gcloud run jobs replace secara default akan menggunakan file job.yaml jika ada.

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Tambahkan kode berikut ke resource google_cloud_run_v2_job di konfigurasi Terraform Anda:

resource "google_cloud_run_v2_job" "default" {
   name     = "cloudrun-job"
   location = "REGION"
   deletion_protection = false
   start_execution_token = "START_EXECUTION_SUFFIX"
   template {
      template {
         containers {
         image = "us-docker.pkg.dev/cloudrun/container/job"
         }
      }
   }
}

Ganti kode berikut:

• REGION: Google Cloud region. Misalnya, europe-west1.
• START_EXECUTION_SUFFIX: string unik yang digunakan sebagai akhiran untuk membuat eksekusi baru. Tugas akan siap saat eksekusi berhasil dimulai. Jumlah panjang nama tugas dan token harus kurang dari 63 karakter.

Library klien

Untuk segera menjalankan tugas dari kode menggunakan Library Klien Cloud:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Untuk menjalankan tugas segera setelah dibuat, kirim permintaan HTTP POST ke endpoint jobs Cloud Run Admin API.

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{
     "template": {
        "template": {
           "containers":
              {
                 "image": "IMAGE_URL"
              }
        }
     },
     "startExecutionToken": "START_EXECUTION_SUFFIX"
  }' \
  "https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB_NAME"

Ganti kode berikut:

• ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk membuat tugas. Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
• IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
• START_EXECUTION_SUFFIX: string unik yang digunakan sebagai akhiran untuk membuat eksekusi baru. Tugas akan siap saat eksekusi berhasil dimulai. Jumlah panjang nama tugas dan token harus kurang dari 63 karakter.
• PROJECT_ID: Google Cloud Project ID
• REGION: Google Cloud region tugas.
• JOB_NAME: nama tugas yang ingin Anda buat.

Menunda eksekusi

Untuk menonaktifkan eksekusi langsung, atau mengonversi tugas reguler menjadi tugas tertunda, lihat Menunda eksekusi tugas.

Mengganti konfigurasi tugas untuk eksekusi tertentu

Dengan menetapkan parameter ini saat memulai eksekusi tugas baru, Anda dapat mengganti argumen, variabel lingkungan, jumlah, dan waktu tunggu yang dikonfigurasi untuk menjalankan suatu tugas. Parameter yang Anda tentukan hanya memengaruhi eksekusi ini, bukan eksekusi berikutnya karena definisi tugas yang mendasarinya tidak berubah.

Beberapa kasus penggunaan umum mencakup:

• Anda menjalankan tugas secara terprogram dari kode Anda, dan ingin mengganti argumen dan/atau variabel lingkungan, misalnya untuk memberi tahu tugas lokasi data input untuk eksekusi ini.
• Anda memiliki tugas dengan setiap tugas hanya digunakan untuk memproses satu bagian data input. Anda ingin mengganti jumlah tugas berdasarkan jumlah input yang diproses.
• Waktu berjalannya tugas Anda bervariasi di setiap eksekusi. Anda ingin mengganti waktu tunggu tugas berdasarkan waktu berjalannya tugas yang diharapkan.

Untuk mengganti konfigurasi tugas suatu eksekusi:

Konsol

1. Buka halaman tugas Cloud Run

2. Temukan tugas yang Anda minati.

3. Klik tugas untuk menampilkan halaman detail tugas.

4. Klik panah luaskan di depan tombol Edit, lalu klik Execute dengan penggantian untuk menampilkan formulir Jalankan tugas dengan penggantian.

   

5. Ubah argumen, variabel lingkungan, jumlah tugas, dan/atau konfigurasi waktu tunggu tugas untuk eksekusi ini sesuai keinginan, lalu klik Jalankan.

gcloud

Gunakan perintah:

gcloud run jobs execute JOB_NAME \
     --args ARGS \
     --update-env-vars KEY=VALUE>,KEY_N=VALUE_N \
     --tasks TASKS \
     --task-timeout TIMEOUT

Ganti kode berikut:

• JOB_NAME: nama tugas.
• ARGS: argumen tugas.
• Pasangan KEY dan VALUE: variabel lingkungan.
• TASKS: jumlah tugas.
• TIMEOUT: waktu tunggu tugas.

Library klien

Untuk menjalankan tugas yang ada dari kode, dengan mengganti konfigurasi tugas:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Untuk mengganti konfigurasi tugas untuk tugas yang ada, kirim permintaan HTTP POST ke endpoint jobs Cloud Run Admin API

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{"overrides": {"containerOverrides": [{"args": ["ARGS"], "env": [{"name": "KEY", "value": "VALUE"}]}], "taskCount": TASKS, "timeout": "TIMEOUT" }}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME:run

Ganti kode berikut:

• ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk menjalankan penggantian tugas. Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
• JOB_NAME: nama tugas.
• ARGS: argumen tugas.
• Pasangan KEY dan VALUE: variabel lingkungan.
• TASKS: jumlah tugas.
• TIMEOUT: waktu tunggu tugas.
• REGION: Google Cloud region tugas.
• PROJECT_ID: Google Cloud Project ID

Membatalkan eksekusi tugas

Penting: Pada 16 September 2024, izin yang diperlukan untuk membatalkan tugas Cloud Run diubah menjadi run.executions.cancel. Peran yang telah ditetapkan sebelumnya untuk Cloud Run Developer dan Cloud Run Source Developer berisi izin ini.

Untuk menghentikan eksekusi tugas Cloud Run yang sedang berjalan, gunakan fitur pembatalan. Membatalkan eksekusi tugas akan menghentikan eksekusi tugas saat ini. Eksekusi yang dibatalkan akan berstatus cancelled. Anda tetap dapat melihat eksekusi tersebut, termasuk data konfigurasi, log, dan data pemantauan.

Catatan: Sebagai perbandingan, jika Anda menggunakan metode delete eksekusi tugas untuk menghentikan eksekusi tugas saat ini, Cloud Run akan menghapus eksekusi dari daftar eksekusi tugas dan Anda tidak dapat melihatnya.

Membatalkan eksekusi tugas tidak akan membatalkan tagihan untuk penggunaan tugas Cloud Run selama tugas dijalankan.

Untuk membatalkan eksekusi:

Konsol

1. Buka halaman tugas Cloud Run

2. Klik tugas untuk membuka panel detail tugas.

3. Pilih eksekusi tugas yang ingin Anda batalkan.

4. Di menu Tindakan, klik ikon elipsis, lalu klik Batalkan.

gcloud

Gunakan perintah:

gcloud run jobs executions cancel EXECUTION_NAME

Ganti EXECUTION_NAME dengan nama eksekusi.

Perintah ini meminta konfirmasi, jadi tanggapi permintaan dengan memasukkan y untuk mengonfirmasi.

Library klien

Untuk membatalkan eksekusi tugas dari kode:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

Untuk membatalkan eksekusi tugas, kirim permintaan HTTP POST ke endpoint jobs Cloud Run Admin API

Misalnya, menggunakan curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME/executions/EXECUTION-NAME:cancel

Ganti kode berikut:

• ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk membatalkan eksekusi tugas. Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container.
• JOB_NAME: nama tugas.
• EXECUTION-NAME: nama eksekusi tugas.
• REGION: Google Cloud region tugas.
• PROJECT_ID: Google Cloud Project ID

Menghapus eksekusi tugas

Anda dapat menghapus eksekusi tugas, meskipun sedang dijalankan. Jika sebuah eksekusi dihapus, eksekusi akan berhenti dilanjutkan. Untuk mengetahui detailnya, lihat Menghapus eksekusi tugas.

Langkah berikutnya

Setelah Anda menyelesaikan eksekusi tugas, Anda dapat melakukan tahapan berikut:

• Lihat log tugas
• Memantau performa tugas
• Mengelola eksekusi tugas
• Mengelola tugas