Définir le nombre maximal de nouvelles tentatives pour les 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.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer des jobs Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre job Cloud Run communique avec des APIGoogle Cloud , telles que des bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les pages Autorisations de déploiement et Gérer les accès.

Configurer le nombre maximal de nouvelles tentatives

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

Console

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

    Accédez à Cloud Run

  2. Sélectionnez Jobs dans le menu, puis cliquez sur Déployer un conteneur pour remplir la page des paramètres initiaux du job. Si vous configurez un job existant, sélectionnez-le, puis cliquez sur Modifier.

  3. Cliquez sur Conteneur(s), Volumes, Connexions, Sécurité pour développer la page des propriétés du job.

  4. Cliquez sur l'onglet Général.

    image

    • Spécifiez le nombre de tentatives en utilisant un entier compris entre 0 et 10.

  5. Cliquez sur Créer ou Mettre à jour.

gcloud

  1. Pour un job 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 job.
    • IMAGE_URL : 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.

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

    gcloud run jobs update JOB_NAME --max-retries RETRY

YAML

  1. Si vous créez un job, ignorez cette étape. Si vous mettez à jour un job existant, téléchargez sa configuration YAML :

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

  2. 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.

  3. Mettez à jour la configuration de job existante :

    gcloud run jobs replace job.yaml

Terraform

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

Ajoutez les éléments suivants à une ressource google_cloud_run_v2_job dans votre configuration 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"
      }
    }
  }
}

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

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

    Accéder aux jobs Cloud Run

  2. Cliquez sur le job qui vous intéresse pour ouvrir la page Informations sur le job.

  3. Cliquez sur Afficher et modifier la configuration du job.

  4. Recherchez le paramètre de nombre maximum de nouvelles tentatives dans les détails de la configuration.

gcloud

  1. Exécutez la commande suivante :

    gcloud run jobs describe JOB_NAME

  2. Recherchez le paramètre du nombre maximal de nouvelles tentatives dans la configuration renvoyée.