Set task timeout (jobs)

Stay organized with collections Save and categorize content based on your preferences.

By default, each task runs for a maximum of 10 minutes: you can change this to a shorter time or a longer time up to 1 hour, by changing the task timeout setting as described in this page. There is no explicit timeout on a job execution: when all tasks are done, the job execution is done.

In the case of retries, the timeout setting applies to each attempt of a task. If the task attempt does not complete within this time, it will be stopped.

The units specify a duration; for example, 10m5s is ten minutes and five seconds. If you don't specify a unit, seconds are assumed as the unit. For example, the value 10 is 10 seconds.

To specify task timeout for a Cloud Run job:

Console

  1. Go to Cloud Run

  2. If you are configuring a new job, click the Jobs tab and fill out the initial job settings page as desired. If you are configuring an existing job, click the job, then click Edit.

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

  4. Click the General tab.

    image

  5. Specify the maximum duration for the job tasks in the current job, specifying both the amount of time and the units: for example, 10m5s is ten minutes and five seconds.

  6. Click Create or Update.

Command line

  1. For a job you are creating:

    gcloud beta run jobs create JOB_NAME --image IMAGE_URL --task-timeout TIMEOUT

    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.
    • TIMEOUT with the maximum duration for the job tasks, specifying the amount of time and the units: for example, 10m5s is ten minutes and five seconds.
  2. For a job you are updating:

    gcloud beta run jobs update JOB_NAME --task-timeout TIMEOUT

View task timeout settings

To view the current task timeout settings for your Cloud Run job:

Console

  1. 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 task timeout setting in the configuration details.

Command line

  1. Use the following command:

    gcloud beta run jobs describe JOB_NAME
  2. Locate the task timeout setting in the returned configuration.