Imposta il numero massimo di nuovi tentativi (job)

Un job Cloud Run è costituito da una o più attività. L'impostazione per il numero massimo di nuovi tentativi specifica il numero di volte in cui un'attività può essere riavviata in caso di errore prima di essere non riuscita definitivamente. Il valore predefinito è 3.

Questa impostazione si applica in base all'attività, non al job. Se lo imposti su 0, le attività vengono eseguite una sola volta e non vengono tentate di nuovo in caso di errore.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti i ruoli IAM seguenti:

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il job Cloud Run si interfaccia con le API Google Cloud, ad esempio le librerie client di Cloud, consulta la guida alla configurazione delle identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestione dell'accesso.

Configura il numero massimo di nuovi tentativi

Per specificare il numero massimo di nuovi tentativi:

Console

  1. Nella console Google Cloud, vai alla pagina dei job Cloud Run:

    Vai a Cloud Run

  2. Se stai configurando un nuovo job, fai clic sulla scheda Job e compila la pagina iniziale delle impostazioni del job come preferisci. Se stai configurando un job esistente, fai clic sul job e poi su Modifica.

  3. Fai clic su Container, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Generali.

    immagine

    • Specifica il numero di nuovi tentativi utilizzando un numero intero compreso tra 0 e 10.

  5. Fai clic su Crea o Aggiorna.

Riga di comando

  1. Per un job che stai creando:

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

    Sostituisci

    • JOB_NAME con il nome del job.
    • IMAGE_URL con un riferimento all'immagine container, ad esempio us-docker.pkg.dev/cloudrun/container/job:latest.
    • RETRY con il numero di nuovi tentativi: specifica un numero intero compreso tra 0 e 10.

  2. Per un lavoro che stai aggiornando:

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

Scarica e visualizza la configurazione esistente dei job utilizzando il comando gcloud run jobs describe --format export, che restituisce risultati puliti in formato YAML. Quindi modifica i campi descritti di seguito e carica il file YAML modificato utilizzando il comando gcloud run jobs replace. Assicurati di modificare i campi solo come documentato.

  1. Per visualizzare e scaricare la configurazione:

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

  2. Aggiorna l'attributo maxRetries::

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

    Sostituisci RETRIES con il numero di nuovi tentativi: specifica un numero intero compreso tra 0 e 10.

    Puoi anche specificare ulteriori configurazioni, ad esempio variabili di ambiente o limiti di memoria.

  3. Aggiorna la configurazione del job esistente:

    gcloud run jobs replace job.yaml

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Per specificare il numero massimo di nuovi tentativi per un job Cloud Run, utilizza la risorsa google_cloud_run_v2_job e applica lo snippet seguente al file 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"
      }
    }
  }
}

Visualizza le impostazioni relative al numero massimo di nuovi tentativi

Per visualizzare le impostazioni correnti relative ai nuovi tentativi massimi per il job Cloud Run:

Console

  1. Nella console Google Cloud, vai alla pagina dei job Cloud Run:

    Vai ai job Cloud Run

  2. Fai clic sul job che ti interessa per aprire la pagina Dettagli job.

  3. Fai clic sulla scheda Configuration (Configurazione).

  4. Individua l'impostazione relativa al numero massimo di nuovi tentativi nei dettagli della configurazione.

Riga di comando

  1. Utilizza il seguente comando:

    gcloud run jobs describe JOB_NAME

  2. Individua l'impostazione relativa al numero massimo di nuovi tentativi nella configurazione restituita.