Configurar reintentos máximos (trabajos)

Un trabajo de Cloud Run consta de una o más tareas. La configuración de reintentos máximos especifica la cantidad de veces que una tarea puede reiniciarse en caso de que falle antes de que la falla sea permanente. El valor predeterminado es 3.

Esta configuración se aplica por tarea, no por trabajo. Si configuras esto en 0, las tareas solo se ejecutan una vez y no se reintentan en caso de error.

Para especificar los reintentos máximos, sigue estos pasos:

Consola

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

    Ir a Cloud Run

  2. Si quieres configurar un nuevo trabajo, haz clic en la pestaña Trabajos y completa la página de configuración de trabajo inicial como desees. Si quieres configurar un trabajo existente, haz clic en el trabajo y, luego, en Editar.

  3. Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.

  4. Haz clic en la pestaña General.

    imagen

    • Especifica la cantidad de reintentos mediante un número entero de 0 a 10.
  5. Haz clic en Crear o Actualizar.

Línea de comandos

  1. Para un trabajo que estés creando, sigue estos pasos:

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

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo.
    • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest
    • RETRY por la cantidad de reintentos: especifica un número entero de 0 a 10.
  2. Para un trabajo que estás actualizando:

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

Descarga y visualiza la configuración del trabajo existente mediante el comando gcloud run jobs describe --format export, que genera resultados limpios en formato YAML. Luego, modifica los campos que se describen a continuación y sube el YAML modificado mediante el comando gcloud run jobs replace. Asegúrate de modificar los campos tal como se indica en la documentación.

  1. Para ver y descargar la configuración, ejecuta el siguiente comando:

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. Actualiza el atributo maxRetries::

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

    Reemplaza RETRIES por la cantidad de reintentos: especifica un número entero de 0 a 10.

    También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

  3. Actualiza la configuración del trabajo existente:

    gcloud run jobs replace job.yaml

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Si deseas especificar los reintentos máximos para un trabajo de Cloud Run, usa el recurso google_cloud_run_v2_job y aplica el siguiente fragmento a tu archivo main.tf:

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

Ver la configuración máxima de reintentos

Para ver la configuración máxima actual de reintentos para tu trabajo de Cloud Run, sigue estos pasos:

Consola

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

    Ir a Trabajos de Cloud Run

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

  3. Haz clic en la pestaña Configuración.

  4. Ubica la configuración de reintentos máximas en los detalles de configuración.

Línea de comandos

  1. Usa el siguiente comando:

    gcloud run jobs describe JOB_NAME
  2. Busca la configuración de reintentos máximos en la configuración que se muestra.