Menetapkan percobaan ulang maksimum untuk tugas

Job Cloud Run terdiri dari satu tugas atau lebih. Setelan jumlah percobaan maksimum menentukan berapa kali tugas diizinkan untuk dimulai ulang jika terjadi kegagalan sebelum gagal secara permanen. Defaultnya adalah 3.

Setelan ini berlaku per tugas, bukan per job. Jika Anda menetapkannya ke 0, tugas hanya akan berjalan sekali dan tidak dicoba lagi jika gagal.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi tugas Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:

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.

Mengonfigurasi percobaan ulang maksimum

Anda dapat mengonfigurasi percobaan ulang maksimum untuk tugas Cloud Run menggunakan konsolGoogle Cloud , gcloud CLI, YAML, atau Terraform:

Konsol

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

    Buka Cloud Run

  2. Pilih Jobs dari menu navigasi Cloud Run:

    1. Jika Anda membuat tugas baru, klik Deploy container untuk mengisi halaman setelan tugas awal.

    2. Jika Anda mengonfigurasi tugas yang ada, pilih tugas, lalu klik Lihat dan edit konfigurasi tugas.

  3. Klik Containers, Connections, Security untuk memperluas halaman properti tugas.

  4. Di bagian Kapasitas tugas, tentukan jumlah percobaan ulang menggunakan bilangan bulat dari 0 hingga 10.

  5. Klik Buat atau Perbarui.

gcloud

  • Untuk menetapkan percobaan ulang maksimum saat Anda membuat tugas baru, jalankan perintah berikut:

    gcloud run jobs create JOB --image IMAGE_URL --max-retries RETRY

    Ganti kode berikut:

    • JOB: nama tugas Cloud Run Anda.
    • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY: jumlah percobaan ulang. Tentukan bilangan bulat dari 0 hingga 10.

  • Untuk memperbarui percobaan ulang maksimum untuk tugas yang ada, jalankan perintah berikut:

    gcloud run jobs update JOB --max-retries RETRY

YAML

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

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

  2. Perbarui atribut maxRetries::

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE_URL
          maxRetries: RETRY

    Ganti kode berikut:

    • JOB: nama tugas Cloud Run Anda.
    • IMAGE_URL: referensi ke image container—misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY: jumlah percobaan ulang. Tentukan bilangan bulat dari 0 hingga 10.

  3. Buat atau perbarui tugas menggunakan perintah berikut:

    gcloud run jobs replace job.yaml

    Perintah gcloud run jobs replace secara default 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     = "cloud-run-job-retries"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      max_retries = 3

      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Lihat setelan percobaan ulang maksimum

Untuk melihat setelan percobaan ulang maksimum saat ini untuk tugas Cloud Run Anda, gunakan konsol Google Cloud atau Google Cloud CLI:

Konsol

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

    Buka tugas Cloud Run

  2. Klik tugas untuk membuka halaman Detail tugas.

  3. Klik Lihat dan edit konfigurasi tugas.

  4. Temukan setelan percobaan ulang maksimum di detail konfigurasi.

gcloud

  1. Jalankan perintah berikut:

    gcloud run jobs describe JOB

  2. Temukan setelan percobaan ulang maksimum dalam konfigurasi yang ditampilkan.