Imposta numero massimo di nuovi tentativi (job)

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

Questa impostazione si applica per attività, non per job. Se lo imposti su 0, le attività vengono eseguite una sola volta e non vengono ritentate in caso di errore.

Ruoli obbligatori

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

Per un elenco dei ruoli e delle 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 dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'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 Contenitore, variabili e secret, connessioni, sicurezza per espandere la pagina delle proprietà del job.

  4. Fai clic sulla scheda Generale.

    immagine

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

  5. Fai clic su Crea o Aggiorna.

gcloud

  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 tuo 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 job che stai aggiornando:

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

  1. Se stai creando un nuovo job, salta questo passaggio. Se stai aggiornando un job esistente, scarica la relativa configurazione YAML:

    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, come le variabili di ambiente o i 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, vedi Comandi Terraform di base.

Per specificare il numero massimo di nuovi tentativi per un job Cloud Run, utilizza google_cloud_run_v2_job risorsa 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 del numero massimo di nuovi tentativi attuali 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 lavoro che ti interessa per aprire la pagina Dettagli offerta di lavoro.

  3. Fai clic sulla scheda Configuration (Configurazione).

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

gcloud

  1. Utilizza questo comando:

    gcloud run jobs describe JOB_NAME

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