Créer des jobs

Cette page explique comment créer et mettre à jour des jobs Cloud Run à partir d'une image de conteneur existante. Contrairement à un service Cloud Run, qui écoute et diffuse les requêtes, un job Cloud Run n'exécute que ses tâches et se ferme une fois qu'elle a terminé. Un job n'écoute pas et ne diffuse pas les requêtes.

Après avoir créé ou mis à jour un job, vous pouvez effectuer les opérations suivantes :

Vous pouvez structurer un job en tant que tâche unique ou en tant que plusieurs tâches indépendantes (jusqu'à 10 000 tâches) pouvant être exécutées en parallèle. Chaque tâche exécute une instance de conteneur et peut être configurée de manière à être relancée en cas d'échec. Chaque opération connaît son index, qui est stocké dans la variable d'environnement CLOUD_RUN_TASK_INDEX. Le nombre total de tâches est stocké dans la variable d'environnement CLOUD_RUN_TASK_COUNT. Si vous traitez des données en parallèle, votre code est chargé de déterminer quelle tâche gère quel sous-ensemble de données.

Vous pouvez définir des délais avant expiration sur des tâches et spécifier le nombre de tentatives en cas d'échec de la tâche. Si une tâche dépasse son nombre maximal de tentatives, elle est marquée comme failed (échec). Si des tâches ont échoué, l'exécution du job est marquée comme failed (échec) une fois que Cloud Run a essayé toutes les tâches.

Par défaut, chaque tâche s'exécute pendant 10 minutes au maximum. Vous pouvez modifier la valeur par défaut en changeant le paramètre de délai avant expiration des tâches, jusqu'à 168 heures (7 jours). Pour les tâches utilisant des GPU, le délai avant expiration maximal disponible est d'une heure.

Il n'y a pas de délai explicite pour l'exécution d'un job : lorsque toutes les tâches sont terminées, l'exécution du job est terminé.

Les jobs utilisent l'environnement d'exécution de deuxième génération.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer 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.

Registres de conteneurs et images acceptés

Vous pouvez utiliser directement des images de conteneurs stockées dans Artifact Registry, ou des images publiques provenant de Docker Hub ou GitHub Container Registry. Google recommande d'utiliser Artifact Registry. Les images publiques de GitHub Container Registry et les images Docker Hub sont mises en cache pendant une heure maximum.

Vous pouvez utiliser des images de conteneurs provenant d'autres registres publics ou privés (tels que JFrog Artifactory ou Nexus), ou des images privées de GitHub Container Registry, en configurant un dépôt Artifact Registry distant.

Envisagez d'utiliser Docker Hub uniquement pour déployer des images de conteneurs populaires, telles que des images officielles Docker ou des images OSS sponsorisées par Docker. Pour accroître la disponibilité, Google recommande de déployer ces images Docker Hub ou GitHub Container Registry à l'aide d'un dépôt Artifact Registry distant.

Cloud Run ne prend pas en charge les calques d'image de conteneur de plus de 9,9 Go lors du déploiement à partir de Docker Hub ou d'un dépôt distant Artifact Registry avec un registre externe.

Créer un job

Vous pouvez créer un job à l'aide de la console Google Cloud , de la gcloud CLI, de YAML, de Terraform, des bibliothèques clientes ou de l'API REST :

Console

Pour créer un job :

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

    Accéder aux jobs Cloud Run

  2. Cliquez sur Déployer un conteneur pour afficher le formulaire Créer un job.

  3. Dans le formulaire, spécifiez l'image de conteneur contenant le code de la tâche ou sélectionnez-la dans la liste des conteneurs précédemment déployés.

  4. Le nom du job est généré automatiquement à partir de l'image de conteneur. Vous pouvez modifier le nom du job si nécessaire dans le formulaire. Une fois le formulaire envoyé, vous ne pourrez plus modifier le nom du job.

  5. Dans le champ Région, sélectionnez la région pour votre tâche. Le sélecteur de région met en avant les régions ayant l'impact carbone le plus faible.

  6. Spécifiez le nombre de tâches à exécuter dans le job. Toutes les tâches doivent réussir pour que le job aboutisse. Par défaut, les tâches s'exécutent en parallèle.

  7. Cliquez sur Conteneurs, mise en réseau, sécurité pour définir d'autres propriétés de job.

  8. Dans la section Modifier le conteneur, vous pouvez configurer les paramètres suivants dans les onglets appropriés :

  9. Dans la section Capacité de la tâche, spécifiez les éléments suivants :

    1. Dans le champ Délai avant expiration de la tâche, spécifiez la durée maximale en secondes pendant laquelle la tâche peut être exécutée, dans la limite de 168 heures (7 jours). Pour les tâches utilisant des GPU, le délai avant expiration maximal disponible est d'une heure. Chaque tâche doit être terminée dans ce délai. La valeur par défaut est de 10 minutes.

    2. Dans le champ Nombre de nouvelles tentatives par tâche en échec, spécifiez le nombre de tentatives en cas d'échec de la tâche. La valeur par défaut est de trois nouvelles tentatives.

  10. Sous Parallélisme, sélectionnez Exécuter simultanément autant de tâches que possible si vous devez définir une limite inférieure en raison de contraintes de scaling sur les ressources auxquelles votre job accède, ou sélectionnez Limiter le nombre maximal de tâches simultanées et spécifiez le nombre de tâches simultanées dans le champ Limite de parallélisme personnalisée.

  11. Une fois la tâche configurée, cliquez sur Créer pour créer la tâche dans Cloud Run.

  12. Pour exécuter le job, consultez la page Exécuter des jobs ou Exécuter des jobs selon un calendrier.

gcloud

Pour utiliser la ligne de commande, vous devez déjà avoir configuré gcloud CLI.

Pour créer un job :

  1. Exécutez la commande suivante : 

    gcloud run jobs create JOB --image IMAGE_URL OPTIONS
     Vous pouvez également utiliser la commande de déploiement : 
    gcloud run jobs deploy JOB --image IMAGE_URL OPTIONS

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).

    • OPTIONS (facultatif) : l'une des options suivantes :

      Option Description
      --tasks Accepte les entiers supérieurs ou égaux à 1. La valeur par défaut est 1. La valeur maximale est 10 000. Chaque tâche reçoit les variables d'environnement CLOUD_RUN_TASK_INDEX avec une valeur comprise entre 0 et le nombre de tâches moins 1, ainsi que CLOUD_RUN_TASK_COUNT, qui correspond au nombre de tâches.
      --max-retries Nombre de nouvelles tentatives d'exécution d'une tâche ayant échoué. Lorsqu'une tâche dépasse cette limite, l'intégralité de la tâche est marquée comme étant en échec. Par exemple, si vous définissez la valeur sur 1, une tâche ayant échoué est relancée une seule fois, soit un total de deux tentatives. La valeur par défaut est 3. Accepte les entiers compris entre 0 et 10.
      --task-timeout Accepte une durée telle que "2s". La valeur par défaut est de 10 minutes. La durée maximale est de 168 heures (7 jours). Pour les tâches utilisant des GPU, le délai avant expiration maximal disponible est d'une heure.
      --parallelism Nombre maximal de tâches pouvant s'exécuter en parallèle. Par défaut, les tâches sont démarrées aussi rapidement que possible en parallèle. Pour connaître la plage de valeurs, consultez la page Parallélisme.
      --execute-now Si ce champ est défini immédiatement après la création de la tâche, une exécution de tâche démarre. Équivaut à l'appel de gcloud run jobs create suivi de gcloud run jobs execute.

      Outre les options ci-dessus, vous spécifiez d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.

      Pour obtenir la liste complète des options disponibles lors de la création d'une tâche, reportez-vous à la documentation de ligne de commande portant sur gcloud run jobs create.

  2. Patientez pendant la création de la tâche. Un message de réussite s'affiche une fois l'opération terminée.

  3. Pour exécuter le job, consultez la page Exécuter des jobs ou Exécuter des jobs selon un calendrier.

YAML

Vous pouvez stocker votre spécification de tâche dans un fichier YAML, puis la déployer à l'aide de gcloud CLI.

  1. Créez un fichier job.yaml avec le contenu suivant :

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE_URL

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).

    Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.

  2. Déployez le nouveau job en exécutant la commande suivante :

    gcloud run jobs replace job.yaml

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez 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"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

Bibliothèques clientes

Pour créer un job à partir du code, procédez comme suit :

API REST

Pour créer un job, envoyez une requête HTTP POST au point de terminaison jobs de l'API Cloud Run Admin.

Exemple, à l'aide de curl :

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB

Remplacez les éléments suivants :

  • ACCESS_TOKEN : jeton d'accès valide pour un compte disposant des autorisations IAM pour créer des jobs. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
  • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : Google Cloud région du job.
  • JOB : nom du job que vous souhaitez créer.

Emplacements Cloud Run

Cloud Run est régional, ce qui signifie que l'infrastructure qui exécute vos services Cloud Run est située dans une région spécifique et gérée par Google pour être disponible de manière redondante dans toutes les zones de cette région.

Lors de la sélection de la région dans laquelle exécuter vos services Cloud Run, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez généralement sélectionner la région la plus proche de vos utilisateurs, mais vous devez tenir compte de l'emplacement des autres Google Cloudproduits utilisés par votre service Cloud Run. L'utilisation conjointe de produits Google Cloud dans plusieurs emplacements peut avoir une incidence sur la latence et le coût de votre service.

Cloud Run est disponible dans les régions suivantes :

Soumis aux tarifs de niveau 1

Soumis aux tarifs de niveau 2

Si vous avez déjà créé un service Cloud Run, vous pouvez afficher la région dans le tableau de bord Cloud Run de la consoleGoogle Cloud .

Lorsque vous créez un job, l'agent de service Cloud Run doit pouvoir accéder au conteneur, ce qui est le cas par défaut.

Mettre à jour un job existant

La modification des paramètres de configuration nécessite de mettre à jour le job, même si l'image de conteneur ne change pas. Notez que pour les paramètres inchangés, les paramètres précédents continuent d'être utilisés.

Vous pouvez mettre à jour un job existant à l'aide de la console Google Cloud , de gcloud CLI, de YAML, de Terraform, des bibliothèques clientes ou de l'API REST :

Console

Pour modifier un job existant, procédez comme suit :

  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 pour afficher la page Informations sur le job.

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

  4. Si nécessaire, modifiez le nombre de tâches figurant dans le job.

  5. Facultatif : Cliquez sur Conteneurs, mise en réseau, sécurité pour mettre à jour d'autres propriétés du job :

  6. Dans la section Capacité de la tâche, spécifiez les éléments suivants :

    1. Dans le champ Délai avant expiration de la tâche, spécifiez la durée maximale en secondes pendant laquelle la tâche peut être exécutée, dans la limite de 168 heures (7 jours). Pour les tâches utilisant des GPU, le délai avant expiration maximal disponible est d'une heure. Chaque tâche doit être terminée dans ce délai. La valeur par défaut est de 10 minutes.

    2. Dans le champ Nombre de nouvelles tentatives par tâche en échec, spécifiez le nombre de tentatives en cas d'échec de la tâche. La valeur par défaut est de trois nouvelles tentatives.

  7. Sous Parallélisme, sélectionnez Exécuter simultanément autant de tâches que possible si vous devez définir une limite inférieure en raison de contraintes de scaling sur les ressources auxquelles votre job accède, ou sélectionnez Limiter le nombre maximal de tâches simultanées et spécifiez le nombre de tâches simultanées dans le champ Limite de parallélisme personnalisée.

  8. Une fois la tâche configurée, cliquez sur Mettre à jour pour modifier la tâche dans Cloud Run et attendez la fin de la création de la tâche.

  9. Pour exécuter le job, consultez la page Exécuter des jobs ou Exécuter des jobs selon un calendrier.

gcloud

  1. Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

  2. Exécutez la commande suivante : 

    gcloud run jobs update JOB

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run

    • OPTIONS (facultatif) : avec les options suivantes :

      Option Description
      --tasks Accepte les entiers supérieurs ou égaux à 1. La valeur par défaut est 1. La valeur maximale est 10 000. Chaque tâche reçoit les variables d'environnement CLOUD_RUN_TASK_INDEX avec une valeur comprise entre 0 et le nombre de tâches moins 1, ainsi que CLOUD_RUN_TASK_COUNT, qui correspond au nombre de tâches.
      --max-retries Nombre de nouvelles tentatives d'exécution d'une tâche ayant échoué. Lorsqu'une tâche dépasse cette limite, l'intégralité de la tâche est marquée comme étant en échec. Par exemple, si vous définissez la valeur sur 1, une tâche ayant échoué est relancée une seule fois, soit un total de deux tentatives. La valeur par défaut est 3. Accepte les entiers compris entre 0 et 10.
      --task-timeout Accepte une durée telle que "2s". La valeur par défaut est de 10 minutes. La durée maximale est de 168 heures (7 jours).
      --parallelism Nombre maximal de tâches pouvant s'exécuter en parallèle. Par défaut, les tâches sont démarrées aussi rapidement que possible en parallèle. Pour connaître la plage de valeurs, consultez la page Parallélisme.

    Outre les options ci-dessus, vous pouvez définir d'autres paramètres de configuration facultatifs :

    Pour obtenir la liste complète des options disponibles lors de la création d'une tâche, reportez-vous à la documentation de ligne de commande portant sur gcloud run jobs create.

  3. Patientez jusqu'à la fin de la mise à jour de la tâche. Une fois l'opération achevée, un message de réussite semblable au suivant s'affiche :

    Job [JOB] has been successfully updated.
View details about this job by running `gcloud run jobs describe JOB`.
See logs for this execution at: https://console.cloud.google.com/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB

  4. Pour exécuter le job, consultez la page Exécuter des jobs ou Exécuter des jobs selon un calendrier.

YAML

  1. Si vous devez télécharger ou consulter la configuration d'un job existant, exécutez la commande suivante pour enregistrer les résultats dans un fichier YAML :

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

  2. Modifiez les attributs enfants spec.template selon vos besoins, puis redéployez en exécutant la commande suivante :

    gcloud run jobs replace job.yaml

    La commande gcloud run jobs replace utilise par défaut le fichier job.yaml s'il est présent.

  3. Pour exécuter le job, consultez la page Exécuter des jobs ou Exécuter des jobs selon un calendrier.

Terraform

Modifiez la configuration de votre job dans votre fichier main.tf à l'aide de la commande terraform apply. Des instructions Terraform détaillées sont disponibles pour :

Pour en savoir plus, consultez les options de ligne de commande terraform apply.

Bibliothèques clientes

Pour mettre à jour un job existant à partir du code, procédez comme suit :

API REST

Pour mettre à jour un job, envoyez une requête HTTP PATCH au point de terminaison jobs de l'API Cloud Run Admin.

Exemple, à l'aide de curl :

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB

Remplacez les éléments suivants :

  • ACCESS_TOKEN : jeton d'accès valide pour un compte disposant des autorisations IAM pour mettre à jour des jobs. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
  • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : Google Cloud région du job.
  • JOB : nom du job que vous souhaitez mettre à jour.

Exemple de code

Pour obtenir des exemples de code montrant des tâches, consultez les guides de démarrage rapide spécifiques au langage.

Déployer plusieurs conteneurs sur un job (side-cars)

Dans un déploiement de job Cloud Run avec plusieurs conteneurs (side-cars), il existe un conteneur de job principal qui encapsule la configuration du job et un ou plusieurs conteneurs side-car.

Vous pouvez déployer jusqu'à 10 conteneurs par instance (y compris le conteneur de job principal). Tous les conteneurs d'une instance partagent le même espace de noms réseau et peuvent partager des fichiers à l'aide d'un volume partagé en mémoire.

Cas d'utilisation

Les sidecars sont couramment utilisés dans les cas suivants :

  • Récupérer des métriques personnalisées à partir de jobs Cloud Run et les envoyer au backend de votre choix à l'aide d'agents collecteurs, tels que Prometheus ou OpenTelemetry.
  • Permettre aux applications sans logique HashiCorp Vault intégrée d'utiliser des secrets statiques et dynamiques provenant de Vault à l'aide du side-car Vault.

Déployer un job avec des conteneurs side-car

Vous pouvez déployer plusieurs side-cars sur un job Cloud Run à l'aide de la consoleGoogle Cloud , de la gcloud CLI, de YAML ou de Terraform :

Console

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

    Accéder aux jobs Cloud Run

  2. Pour déployer sur un job existant, cliquez sur Jobs (Jobs). Localisez le job dans la liste des jobs, puis cliquez dessus pour l'ouvrir. Cliquez ensuite sur Afficher et modifier la configuration pour afficher le formulaire de modification du job.

  3. Pour un nouveau job, cliquez sur Déployer un conteneur. Indiquez l'URL de l'image de conteneur et le nom du job.

  4. Cliquez sur Conteneurs, mise en réseau, sécurité.

  5. Dans la fiche Modifier le conteneur, configurez le conteneur de job principal si nécessaire.

  6. Cliquez sur Ajouter un conteneur et configurez un conteneur side-car que vous souhaitez ajouter avec le conteneur de job principal. Si le side-car dépend d'un autre conteneur dans le service, indiquez-le dans le menu déroulant Ordre de démarrage du conteneur. Répétez cette étape pour chaque conteneur side-car que vous déployez.

  7. Cliquez sur Créer pour un nouveau service ou sur Mettre à jour pour un job existant, puis attendez la fin du déploiement.

gcloud

  1. Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

  2. Pour déployer plusieurs conteneurs sur un job, exécutez la commande suivante :

    gcloud run jobs create JOB \
 --container JOB_CONTAINER_NAME \
 --image='IMAGE_URL' \
 --container SIDECAR_CONTAINER_NAME \
 --image='SIDECAR_IMAGE'

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • JOB_CONTAINER_NAME : nom du conteneur de job principal.
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
    • SIDECAR_CONTAINER_NAME : nom du conteneur side-car, par exemple sidecar.
    • SIDECAR_IMAGE : référence à l'image de conteneur side-car.

    Si vous souhaitez configurer chaque conteneur dans la commande de déploiement, indiquez la configuration de chaque conteneur après les paramètres container, par exemple :

    gcloud run jobs create JOB \
  --container CONTAINER_1_NAME \
  --image='IMAGE_URL' \
  --set-env-vars=KEY=VALUE \
  --container SIDECAR_CONTAINER_NAME \
  --image='SIDECAR_IMAGE' \
  --set-env-vars=KEY_N=VALUE_N

  3. Attendez la fin du déploiement des jobs. Une fois l'opération réussie, un message de réussite s'affiche.

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 --format export > job.yaml

  2. Mettez à jour les attributs containers: :

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
      - image: SIDECAR_IMAGE

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
    • SIDECAR_IMAGE : référence à l'image de conteneur side-car.

  3. Créez ou mettez à jour le job à l'aide de la commande suivante :

    gcloud run jobs replace job.yaml

    La commande gcloud run jobs replace utilise par défaut le fichier job.yaml s'il est présent.

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez 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     = "JOB"
  location = "europe-west1"

  template {
    template {
      containers {
        name = "CONTAINER_NAME"
        image = "IMAGE_URL"
      }
      containers {
        name = "SIDECAR_CONTAINER_NAME"
        image = "SIDECAR_IMAGE_URL"
      }
    }
  }
}

Remplacez les éléments suivants :

  • JOB par le nom de votre job Cloud Run
  • CONTAINER_NAME : nom du conteneur.
  • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
  • SIDECAR_CONTAINER_NAME : nom du conteneur side-car.
  • SIDECAR_IMAGE_URL : référence à l'image du conteneur side-car.

Fonctionnalités disponibles pour les déploiements avec side-cars

Vous pouvez spécifier l'ordre de démarrage des conteneurs dans un déploiement comportant plusieurs conteneurs, si vous avez des dépendances nécessitant le démarrage de certains conteneurs avant d'autres conteneurs dans le déploiement.

Si vous avez des conteneurs qui dépendent d'autres conteneurs, vous devez utiliser des vérifications d'état au démarrage dans votre déploiement. Si vous utilisez les vérifications d'état, Cloud Run suit l'ordre de démarrage des conteneurs et inspecte l'état de chaque conteneur, afin de s'assurer que chaque conteneur réussit avant que Cloud Run ne démarre le conteneur suivant dans l'ordre. Si vous n'utilisez pas les vérifications d'état, les conteneurs opérationnels démarrent même si les conteneurs dont ils dépendent ne sont pas en cours d'exécution.

Plusieurs conteneurs d'une même instance peuvent accéder à un volume en mémoire partagé, qui est accessible à chaque conteneur via des points d'installation que vous créez.

Limites

Si votre job se connecte à des instances Cloud SQL à l'aide de la fonctionnalité intégrée de Cloud Run, consultez le problème connu sur les connexions Cloud SQL intégrées.

Étapes suivantes

Après avoir créé ou mis à jour un job, vous pouvez effectuer les opérations suivantes :