Set maximum retries (jobs)

Console

1. In the Google Cloud console, go to the Cloud Run jobs page:

   Go to Cloud Run

2. Click Deploy container and select Job to fill out the initial job settings page. If you are configuring an existing job, select the job, then click Edit.

3. Click Container, variables and secrets, connections, security to expand the job properties page.

4. Click the General tab.

   

   • Specify the number of retries using an integer from 0 to 10.

5. Click Create or Update.

gcloud

1. For a job you are creating:

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

   Replace

   • JOB_NAME with the name of your job.
   • IMAGE_URL with a reference to the container image, for example, us-docker.pkg.dev/cloudrun/container/job:latest.
   • RETRY with the number of retries: specify an integer from 0 to 10.

2. For a job you are updating:

   gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

1. If you are creating a new job, skip this step. If you are updating an existing job, download its YAML configuration:

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

2. Update the maxRetries: attribute:

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

   Replace RETRIES with the number of retries: specify an integer from 0 to 10.

   You can also specify more configuration such as environment variables or memory limits.

3. Update the existing job configuration:

   gcloud run jobs replace job.yaml

Terraform

To learn how to apply or remove a Terraform configuration, see Basic Terraform commands.

To specify maximum retries for a Cloud Run job, use google_cloud_run_v2_job resource and apply the following snippet to your main.tf file:

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"
      }
    }
  }
}

Console

1. In the Google Cloud console, go to the Cloud Run jobs page:

   Go to Cloud Run jobs

2. Click the job you are interested in to open the Job details page.

3. Click the Configuration tab.

4. Locate the maximum retries setting in the configuration details.

gcloud

1. Use the following command:

   gcloud run jobs describe JOB_NAME

2. Locate the maximum retries setting in the returned configuration.