Definir el número máximo de reintentos de las tareas

Un trabajo de Cloud Run consta de una o varias tareas. El ajuste de reintentos máximos especifica el número de veces que se permite reiniciar una tarea en caso de fallo antes de que falle de forma permanente. El valor predeterminado es 3.

Este ajuste se aplica por tarea, no por trabajo. Si le asignas el valor 0, las tareas solo se ejecutan una vez y no se vuelven a intentar si fallan.

Roles obligatorios

Para obtener los permisos que necesitas para configurar los trabajos de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos sobre roles de gestión de identidades y accesos de Cloud Run y permisos de gestión de identidades y accesos de Cloud Run. Si tu trabajo de Cloud Run interactúa con APIs deGoogle Cloud , como las bibliotecas de cliente de Cloud, consulta la guía de configuración de la identidad de servicio. Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.

Configurar el número máximo de reintentos

Para especificar el número máximo de reintentos, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página de trabajos de Cloud Run:

    Ir a Cloud Run

  2. Seleccione Trabajos en el menú y haga clic en Implementar contenedor para rellenar la página de configuración inicial del trabajo. Si vas a configurar un trabajo que ya existe, selecciona el trabajo y haz clic en Editar.

  3. Haz clic en Contenedores, volúmenes, conexiones y seguridad para desplegar la página de propiedades del trabajo.

  4. Haz clic en la pestaña General.

    imagen

    • Especifica el número de reintentos con un número entero del 0 al 10.

  5. Haz clic en Crear o en Actualizar.

gcloud

  1. En el caso de una tarea que estés creando:

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

    Sustituir

    • JOB_NAME con el nombre del trabajo.
    • IMAGE_URL: una referencia a la imagen del contenedor. Por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY con el número de reintentos: especifica un número entero entre 0 y 10.

  2. Si quieres actualizar un trabajo:

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

  1. Si vas a crear un trabajo, sáltate este paso. Si vas a actualizar una tarea, descarga su configuración YAML:

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

  2. Actualice el atributo maxRetries::

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

    Sustituye RETRIES por el número de reintentos. Especifica un número entero entre 0 y 10.

    También puede especificar más configuraciones, como variables de entorno o límites de memoria.

  3. Actualiza la configuración de la tarea:

    gcloud run jobs replace job.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Añade lo siguiente a un recurso google_cloud_run_v2_job en tu configuración de Terraform:

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

Ver la configuración de reintentos máximos

Para ver la configuración actual del número máximo de reintentos de tu trabajo de Cloud Run, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página de trabajos de Cloud Run:

    Ir a tareas de Cloud Run

  2. Haz clic en el trabajo que te interese para abrir la página Detalles del trabajo.

  3. Haz clic en Ver y editar configuración del trabajo.

  4. Busca el ajuste de número máximo de reintentos en los detalles de la configuración.

gcloud

  1. Usa el siguiente comando:

    gcloud run jobs describe JOB_NAME

  2. Busca el ajuste de reintentos máximos en la configuración devuelta.