Menetapkan percobaan ulang maksimum (job)

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

Untuk menentukan percobaan ulang maksimum:

Konsol

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

    Buka Cloud Run

  2. Klik Deploy container dan pilih Job untuk mengisi halaman setelan tugas awal. Jika Anda mengonfigurasi tugas yang sudah ada, pilih tugas, lalu klik Edit.

  3. Klik Container, variabel dan secret, koneksi, keamanan untuk memperluas halaman properti tugas.

  4. Klik tab General.

    gambar

    • Tentukan jumlah percobaan ulang menggunakan bilangan bulat dari 0 hingga 10.

  5. Klik Buat atau Perbarui.

gcloud

  1. Untuk job yang Anda buat:

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

    Ganti

    • JOB_NAME dengan nama tugas Anda.
    • IMAGE_URL dengan referensi ke image container, misalnya, us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY dengan jumlah percobaan ulang: tentukan bilangan bulat dari 0 sampai 10.

  2. Untuk job yang Anda perbarui:

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

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

    gcloud run jobs describe JOB_NAME --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
          maxRetries: RETRIES

    Ganti RETRIES dengan jumlah percobaan ulang: tentukan bilangan bulat dari 0 hingga 10.

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

  3. Perbarui konfigurasi job yang ada:

    gcloud run jobs replace job.yaml

Terraform

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

Untuk menentukan percobaan ulang maksimum untuk tugas Cloud Run, gunakan resource google_cloud_run_v2_job dan terapkan cuplikan berikut ke file main.tf 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:

Konsol

  1. Pada konsol Google Cloud, buka halaman tugas Cloud Run.

    Buka tugas Cloud Run

  2. Klik tugas yang Anda minati untuk membuka halaman Detail pekerjaan.

  3. Klik tab Configuration.

  4. Temukan setelan percobaan ulang maksimum di detail konfigurasi.

gcloud

  1. Gunakan perintah berikut:

    gcloud run jobs describe JOB_NAME

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