Définir le nombre maximal de nouvelles tentatives (tâches)

Un job Cloud Run comprend une ou plusieurs tâches. Le paramètre maximal de nouvelles tentatives indique le nombre de fois qu'une opération est autorisée à redémarrer en cas d'échec avant son échec permanent. La valeur par défaut est 3.

Ce paramètre s'applique par opération, et non par tâche. Si vous définissez ce paramètre sur 0, les tâches ne sont exécutées qu'une seule fois et ne font pas l'objet de nouvelles tentatives en cas d'échec.

Pour spécifier le nombre maximal de tentatives, procédez comme suit :

Console

Dans la console Google Cloud, accédez à la page des jobs Cloud Run :

Accédez à Cloud Run
Si vous configurez une nouvelle tâche, cliquez sur l'onglet Tâches et remplissez la page des paramètres initiaux de la tâche selon vos besoins. Si vous configurez une tâche existante, cliquez sur celle-ci, puis sur Modifier.
Cliquez sur Conteneur, variables et secrets, connexions, sécurité pour développer la page des propriétés de la tâche.
Cliquez sur l'onglet Général.
- Spécifiez le nombre de tentatives en utilisant un entier compris entre 0 et 10.
Cliquez sur Créer ou Mettre à jour.

Command line

Pour une tâche que vous êtes en train de créer :
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --max-retries RETRY
```
Remplacer
- JOB_NAME par le nom de votre tâche.
- IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/job:latest.
- RETRY par le nombre de tentatives : spécifiez un entier compris entre 0 et 10.

Pour une tâche en cours de mise à jour :

gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

Téléchargez et affichez la configuration de tâche existante à l'aide de la commande gcloud run jobs describe --format export, qui renvoie les résultats nettoyés au format YAML. Modifiez ensuite les champs décrits ci-dessous et importez le fichier YAML modifié à l'aide de la commande gcloud run jobs replace. Veillez à ne modifier que les champs indiqués.

Pour afficher et télécharger la configuration, exécutez la commande suivante :
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```
Mettez à jour l'attribut maxRetries: :
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
          maxRetries: RETRIES
```
Remplacez RETRIES par le nombre de tentatives : spécifiez un entier compris entre 0 et 10.

Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.
Mettez à jour la configuration de tâche existante :
```
gcloud run jobs replace job.yaml
```

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

Pour spécifier le nombre maximal de tentatives pour une tâche Cloud Run, utilisez la ressource google_cloud_run_v2_job et appliquez l'extrait suivant à votre fichier 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"
      }
    }
  }
}

Afficher le nombre maximal de nouvelles tentatives

Pour afficher les paramètres actuels du nombre maximal de tentatives pour votre tâche Cloud Run, procédez comme suit :

Console

Dans la console Google Cloud, accédez à la page des jobs Cloud Run :

Accéder aux tâches Cloud Run
Cliquez sur la tâche qui vous intéresse pour ouvrir la page Informations sur la tâche.
Cliquez sur l'onglet Configuration.
Recherchez le paramètre de nombre maximum de nouvelles tentatives dans les détails de la configuration.

Command line

Exécutez la commande suivante :
```
gcloud run jobs describe JOB_NAME
```
Recherchez le paramètre du nombre maximal de nouvelles tentatives dans la configuration renvoyée.