Impostare il numero massimo di nuovi tentativi per i job

Un job Cloud Run è composto da una o più attività. L'impostazione del numero massimo di tentativi specifica il numero di volte in cui un'attività può essere riavviata in caso di errore prima di non riuscire in modo permanente. Il valore predefinito è 3.

Questa impostazione si applica per attività, non per job. Se imposti questo valore su 0, le attività vengono eseguite una sola volta e non vengono riprovate 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 di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo job Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per saperne di più sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestisci l'accesso.

Configurare il numero massimo di tentativi

Puoi configurare i tentativi massimi per un job Cloud Run utilizzando la consoleGoogle Cloud , gcloud CLI, YAML o Terraform:

Console

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

    Vai a Cloud Run

  2. Seleziona Job dal menu di navigazione di Cloud Run:

    1. Se stai creando un nuovo job, fai clic su Deploy container per compilare la pagina delle impostazioni iniziali del job.

    2. Se stai configurando un job esistente, selezionalo, quindi fai clic su Visualizza e modifica la configurazione del job.

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

  4. Nella sezione Capacità attività, specifica il numero di tentativi utilizzando un numero intero compreso tra 0 e 10.

  5. Fai clic su Crea o Aggiorna.

gcloud

  • Per impostare il numero massimo di tentativi quando crei un nuovo job, esegui questo comando:

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

    Sostituisci quanto segue:

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

  • Per aggiornare il numero massimo di tentativi per un job esistente, esegui questo comando:

    gcloud run jobs update JOB --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 --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_URL
          maxRetries: RETRY

    Sostituisci quanto segue:

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

  3. Crea o aggiorna il job utilizzando il seguente comando:

    gcloud run jobs replace job.yaml

    Il comando gcloud run jobs replace utilizza per impostazione predefinita il file job.yaml, se presente.

Terraform

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

Aggiungi quanto segue a una risorsa google_cloud_run_v2_job nella configurazione 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"
      }
    }
  }
}

Visualizza le impostazioni relative al numero massimo di tentativi

Per visualizzare le impostazioni correnti del numero massimo di tentativi per il tuo job Cloud Run, utilizza la console Google Cloud o Google Cloud CLI:

Console

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

    Vai ai job Cloud Run

  2. Fai clic sul job per aprire la pagina Dettagli job.

  3. Fai clic su Visualizza e modifica la configurazione del job.

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

gcloud

  1. Esegui questo comando:

    gcloud run jobs describe JOB

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