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.

Untuk menentukan percobaan ulang maksimum:

Konsol

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

    Buka Cloud Run

  2. Jika Anda sedang mengonfigurasi tugas baru, klik tabTugas dan isi halaman setelan tugas awal seperti yang diinginkan. Jika Anda sedang mengonfigurasi tugas yang sudah ada, klik tugas tersebut, lalu klikEdit.

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

  4. Klik tab General.

    gambar

    • Tentukan jumlah percobaan ulang menggunakan bilangan bulat dari 0 hingga 10.
  5. Klik Create atau Update.

Command line

  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

Download dan lihat konfigurasi job yang ada menggunakan perintah gcloud run jobs describe --format export, yang akan memberikan hasil yang dibersihkan dalam format YAML. Kemudian ubah kolom yang dijelaskan di bawah ini dan upload YAML yang telah dimodifikasi menggunakan perintah gcloud run jobs replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

  1. Untuk melihat dan mendownload konfigurasi:

    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 job 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"
  launch_stage = "BETA"

  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.

Command line

  1. Gunakan perintah berikut:

    gcloud run jobs describe JOB_NAME
  2. Temukan setelan percobaan ulang maksimum dalam konfigurasi yang ditampilkan.