Créer des jobs

Console

Pour créer un job, procédez comme suit :

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

   Accédez à Cloud Run

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

   1. 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.
   2. Le nom de la tâche est généré automatiquement à partir de l'image du conteneur. Vous pouvez modifier le nom de la tâche si nécessaire. Un nom de tâche ne peut plus être modifié une fois que la tâche a été créée.
   3. Sélectionnez la région dans laquelle vous souhaitez créer votre tâche. Le sélecteur de région met en avant les régions ayant l'impact carbone le plus faible.
   4. Spécifiez le nombre de tâches que vous souhaitez 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.

3. Cliquez sur Conteneur(s), volumes, mise en réseau, sécurité pour définir d'autres propriétés de job.

   • Sous "Capacité de l'opération" :
   1. Dans le menu Mémoire, spécifiez la quantité de mémoire requise. La valeur par défaut est la valeur minimale requise (512 Mio).
   2. Dans le menu déroulant Processeur, spécifiez la quantité de processeurs requise. La valeur par défaut est la configuration minimale requise (un processeur).

   3. Sous 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). La prise en charge des délais avant expiration supérieurs à 24 heures est disponible en preview. Chaque tâche doit être terminée dans ce délai. La valeur par défaut est de 10 minutes (600 secondes).

   4. Sous 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.

   • Sous "Parallélisme" :

     1. Dans la plupart des cas, vous pouvez sélectionner Exécuter simultanément autant de tâches que possible.
     2. Si vous devez définir une limite inférieure en raison de contraintes de scaling sur les ressources auxquelles votre job accède, 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.

4. Vous pouvez également configurer d'autres paramètres dans les onglets appropriés :

   • Configuration des conteneurs
   • Limites de processeur
   • Limites de mémoire
   • Secrets
   • Variables d'environnement
   • Libellés
   • Comptes de service
   • Connexions Cloud SQL
   • Connectivité VPC

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

6. 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, procédez comme suit :

1. Exécutez la commande suivante :

   gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS

   Vous pouvez également utiliser la commande de déploiement :

   gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

   • Remplacez JOB_NAME par le nom de la tâche que vous souhaitez créer. Vous pouvez omettre ce paramètre, mais dans ce cas, le nom de la tâche vous sera demandé.
   • Remplacez IMAGE_URL par une référence à l'image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/job:latest.

   • Vous pouvez également remplacer OPTIONS par 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 valeur maximale est de 168 heures (7 jours). La prise en charge des délais avant expiration supérieurs à 24 heures est disponible en preview.
     --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

   Remplacer

   • JOB par le nom de votre tâche Cloud Run Les noms de tâche doivent comporter un maximum de 49 caractères et être uniques par région et par projet.
   • IMAGE par l'URL de l'image du conteneur de la tâche.

   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 la nouvelle tâche à l'aide de la commande suivante :

   gcloud run jobs replace job.yaml

Terraform

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

Pour créer un job Cloud Run, utilisez la ressource google_cloud_run_v2_job et modifiez votre fichier main.tf comme indiqué dans l'extrait suivant.

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 :

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

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_NAME

Remplacez :

• ACCESS_TOKEN par un 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.
• JOB_NAME par le nom du job que vous souhaitez créer.
• IMAGE_URL par l'URL de l'image de conteneur du job (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
• REGION par la région Google Cloud du job.
• PROJECT_ID par l'ID du projet Google Cloud.

Console

Pour mettre à jour un job existant :

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

   Accédez à Cloud Run

2. Cliquez sur l'onglet Tâches pour afficher la liste des tâches.

3. Cliquez sur le job pour afficher la page Informations sur le job.

4. Cliquez sur Modifier.

5. Si vous avez modifié le code de votre tâche, spécifiez le nouveau condensé de l'image du conteneur.

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

7. Vous pouvez également cliquer sur Conteneur(s), volumes, mise en réseau et sécurité pour mettre à jour d'autres propriétés du job :

   • Sous "Capacité de l'opération" :
   1. Dans le menu Mémoire, spécifiez la quantité de mémoire requise. La valeur par défaut est la valeur minimale requise (512 Mio).
   2. Dans le menu déroulant Processeur, spécifiez la quantité de processeurs requise. La valeur par défaut est la configuration minimale requise (un processeur).
   3. Sous 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). La prise en charge des délais avant expiration supérieurs à 24 heures est disponible en preview. Chaque tâche doit être terminée dans ce délai. La valeur par défaut est de 10 minutes (600 secondes).
   4. Sous 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.

   • Sous "Parallélisme" :

     1. Dans la plupart des cas, vous pouvez sélectionner Exécuter simultanément autant de tâches que possible.
     2. Si vous devez définir une limite inférieure en raison de contraintes de scaling sur les ressources auxquelles votre job accède, sélectionnez Limiter le nombre maximal de tâches simultanées et spécifiez le nombre maximal de tâches simultanées dans le champ Limite de parallélisme personnalisée.

8. Vous pouvez également configurer d'autres paramètres dans les onglets appropriés :

   • Configuration des conteneurs
   • Limites de processeur
   • Limites de mémoire
   • Secrets
   • Variables d'environnement
   • Libellés
   • Comptes de service
   • Connexions Cloud SQL
   • Connectivité VPC

9. Une fois la tâche configurée, cliquez sur Enregistrer pour créer la tâche dans Cloud Run et attendez la fin de la création de la tâche.

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

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Exécutez la commande suivante :

   gcloud run jobs update JOB_NAME

   Remplacez :

   • JOB_NAME par le nom de la tâche que vous souhaitez mettre à jour.

   • Vous pouvez également remplacer OPTIONS par 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 valeur maximale est de 168 heures (7 jours). La prise en charge des délais avant expiration supérieurs à 24 heures est disponible en preview.
     --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 :

   • Configuration des conteneurs
   • Limites de processeur
   • Limites de mémoire
   • Secrets
   • Variables d'environnement
   • Libellés
   • Comptes de service
   • Connexions Cloud SQL
   • Connexion VPC

   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_NAME] has been successfully updated.
   View details about this job by running `gcloud run jobs describe JOB_NAME`.
   See logs for this execution at: https://console.cloud.google.com/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB_NAME

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

YAML

Si vous devez télécharger ou consulter la configuration d'une tâche existante, exécutez la commande suivante pour enregistrer les résultats dans un fichier YAML :

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

Dans un fichier YAML de configuration de tâche, modifiez les attributs enfants spec.template en fonction de vos besoins pour mettre à jour les paramètres de configuration, puis redéployez votre application :

1. Mettez à jour la configuration de tâche existante :

   gcloud run jobs replace job.yaml

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

• Parallélisme
• Nombre maximal de nouvelles tentatives
• Délais avant expiration

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 :

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

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_NAME

Remplacez :

• ACCESS_TOKEN par un 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.
• JOB_NAME par le nom du job que vous souhaitez mettre à jour.
• IMAGE_URL par l'URL de l'image de conteneur du job (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
• REGION par la région Google Cloud du job.
• PROJECT_ID par l'ID du projet Google Cloud.