Imposta numero massimo di nuovi tentativi (job)

Un job Cloud Run è costituito da una o più attività. Numero massimo di nuovi tentativi specifica il numero di volte in cui un'attività può essere riavviata un errore prima di un errore permanente. L'impostazione predefinita è 3.

Questa impostazione si applica per attività, non per job. Se imposti questo valore su 0, le attività vengono eseguite solo una volta e non viene eseguito alcun nuovo tentativo in caso di errore.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare i job Cloud Run, chiedi all'amministratore di concederti 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 tuo job Cloud Run si interfaccia con Le API Google Cloud, come le librerie client di Cloud, consultano guida alla configurazione dell'identità dei servizi. Per ulteriori informazioni sulla concessione dei ruoli, consulta le autorizzazioni di deployment e gestisci l'accesso.

Configurare 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. Fai clic su Esegui il deployment del container e seleziona Job per compilare il job iniziale. nella pagina delle impostazioni. Se stai configurando un job esistente, seleziona il job, quindi fai clic 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 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, per 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 tentativi: specifica un numero intero da 0 a 10.

    Puoi anche specificare ulteriori configurazioni, ad esempio le variabili di ambiente 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 google_cloud_run_v2_job risorsa e applica il seguente snippet al tuo file main.tf:

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

Visualizza le impostazioni relative al numero massimo di nuovi tentativi

Per visualizzare le attuali impostazioni del numero massimo di nuovi tentativi per il tuo 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 dei tentativi massimi nei dettagli della configurazione.

gcloud

  1. Utilizza il seguente comando:

    gcloud run jobs describe JOB_NAME

  2. Individua l'impostazione del numero massimo di nuovi tentativi nel modulo restituito. configurazione.