Gérer des jobs Cron

Cible Pub/Sub

Si vous choisissez le type de cible Pub/Sub :

  1. Spécifiez le nom du sujet sur lequel le job sera publié. Il s'agit d'un sujet Pub/Sub que vous avez déjà configuré dans votre projet.

  2. Spécifiez un message à envoyer au sujet. Cet élément est envoyé en tant que paramètre data dans le message Pub/Sub. Pour voir un exemple de cette opération, reportez-vous au Démarrage rapide.

  3. Ajoutez les attributs de message dont vous avez besoin.

  4. Configurez les paramètres supplémentaires à l'aide de la section Configure optional settings.

Cloud Scheduler publiera des messages dans ce sujet en tant que compte de service Google APIs.

Cible HTTP App Engine

Si vous choisissez le type de cible App Engine HTTP, vous devez utiliser l'application App Engine et la région associées au projet en cours. Si vous souhaitez utiliser une autre application App Engine ne faisant pas partie du projet en cours, choisissez HTTP comme cible, et non App Engine HTTP. Les règles de pare-feu cibles doivent autoriser les requêtes provenant de la plage d'adresses IP 0.1.0.2/32.

Définissez le formulaire comme suit :

  1. Dans la liste Type de cible, sélectionnez App Engine HTTP.

  2. Indiquez le nom du service App Engine qui exécute le gestionnaire pour le job Cloud Scheduler. En cas d'omission, default est utilisé. Si vous souhaitez le définir, vous trouverez les noms des services dans la consoleGoogle Cloud .

  3. Vous pouvez éventuellement spécifier la version. Si cette dernière n'est pas définie, la version actuellement active est utilisée. Vous pouvez trouver les versions disponibles dans la consoleGoogle Cloud .

  4. Vous pouvez éventuellement spécifier l'instance. Si cette dernière n'est pas définie, n'importe quelle instance disponible peut être utilisée. Vous pouvez trouver les versions disponibles dans la consoleGoogle Cloud .

  5. Spécifiez l'URL relative du point de terminaison App Engine que la tâche va contacter. Si vous utilisez la valeur par défaut /, la tâche utilisera PROJECT-ID.appspot.com, où PROJECT-ID est l'ID de votre projet actuel.

  6. Définissez la méthode HTTP que vous souhaitez utiliser lors de l'exécution du job. La valeur par défaut est POST.

  7. Ajoutez les en-têtes dont vous avez besoin à la requête.

  8. Vous pouvez éventuellement spécifier les données du corps à envoyer à la cible. Ces données sont envoyées dans le corps de la requête en tant qu'octets lorsque la méthode HTTP POST ou PUT est sélectionnée.

Les points de terminaison App Engine ciblés doivent se trouver dans le même projet et peuvent être sécurisés avec login: admin sur l'élément handlers du fichier app.yaml.

Cible HTTP

Si vous choisissez le type de cible HTTP :

  1. Spécifiez l'URL complète du point de terminaison que le job doit contacter.

  2. Spécifiez la méthode HTTP. La valeur par défaut est POST.

  3. Vous pouvez éventuellement spécifier les données à envoyer à la cible. Ces données sont envoyées dans le corps de la requête en tant qu'octets lorsque la méthode HTTP POST ou PUT est sélectionnée.

  4. Ajoutez les en-têtes dont vous avez besoin.

  5. Pour créer un job HTTP cible nécessitant une authentification, consultez la page Utilisez l'authentification avec des cibles HTTP.

Les points de terminaison HTTP ciblés doivent être accessibles au public.

Vous pouvez utiliser Cloud Scheduler pour configurer des unités de travail planifiées, connues en tant que jobs Cron, qui sont envoyés à des cibles sur certains plannings récurrents, également appelés intervalle ou fréquence du job.

Une seule instance d'une tâche doit être exécutée à un instant T. Dans de rares cas, il est possible que plusieurs instances d'un même job soient demandées. Par conséquent, votre gestionnaire de requêtes doit être idempotent, et votre code doit vous assurer qu'il n'y a pas d'effets secondaires néfastes si cela se produit.

Si un job est toujours en cours d'exécution ou en attente d'une réponse de sa cible, les autres exécutions planifiées du job sont ignorées jusqu'à ce que l'exécution en cours se termine ou expire. Pour en savoir plus, consultez Les exécutions de jobs ultérieures ne démarrent pas.

Cloud Scheduler est destiné aux jobs récurrents. Si vous devez exécuter un job une seule fois, envisagez d'utiliser Cloud Tasks, qui peut planifier un job jusqu'à 30 jours à l'avance.

Avant de commencer

Assurez-vous d'avoir configuré votre environnement pour Cloud Scheduler.

Choisir un type de cible

Cloud Scheduler peut appeler les types de cibles suivants :

Appeler des services cibles limités à l'entrée interne

Cloud Scheduler peut appeler les services suivants en interne :

  • Cloud Run Functions
  • Cloud Run (sur l'URL run.app, et non sur les domaines personnalisés)

Pour appeler ces cibles en interne, la cible doit se trouver dans le même projetGoogle Cloud ou périmètre VPC Service Controls que votre job Cloud Scheduler.

Pour en savoir plus sur la sécurisation des cibles en limitant le trafic entrant, consultez Restreindre le trafic entrant (pour Cloud Run) et Configurer les paramètres réseau (pour Cloud Run Functions).

Créer un job

Vous pouvez créer un job à l'aide de la console Google Cloud ou de Google Cloud CLI.

Console

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

    Accéder à Cloud Scheduler

  2. Cliquez sur Créer un job.

  3. Dans le champ Nom, saisissez un nom pour le job, unique au projet.

    Une fois la tâche associée supprimée, vous pouvez réutiliser son nom dans un projet.

  4. Dans la liste Région, sélectionnez une région.

    Si vous utilisez une cible App Engine HTTP, vous devez choisir la même région que votre application App Engine. Pour en savoir plus, consultez Régions compatibles par cible.

  5. Vous pouvez éventuellement fournir une brève description du job, par exemple un rappel de son rôle.

    Cette description s'affiche dans la console à côté du nom du job.

  6. Spécifiez la fréquence à laquelle la tâche doit être exécutée à l'aide d'une chaîne de configuration.

    Par exemple, la chaîne 0 1 * * 0 exécute la tâche une fois par semaine tous les dimanches à une heure du matin. La chaîne que vous fournissez ici peut être n'importe quelle chaîne compatible avec unix-cron. Pour en savoir plus, consultez Configurer des job Cron Cron.

  7. Dans la liste Fuseau horaire, sélectionnez le fuseau horaire à utiliser pour la programmation du job.

  8. Cliquez sur Continuer.

  9. Spécifiez le type de cible :

    • HTTP

    • Pub/Sub : vous devez spécifier le nom du sujet Pub/Sub que vous avez déjà configuré dans votre projet et dans lequel le job sera publié.

    • App Engine HTTP : vous devez utiliser l'application App Engine et la région associées au projet en cours.

  10. Cliquez sur Continuer.

  11. Si vous le souhaitez, cliquez sur Configurer les paramètres facultatifs pour configurer un comportement de réessai. Pour spécifier une durée, utilisez une séquence d'entiers décimaux non négatifs avec les suffixes d'unité suivants :

    • h - heure
    • m - minute
    • s - seconde
    • ms - milliseconde
    • us - microseconde
    • ns - nanoseconde

    Les valeurs négatives et fractionnaires ne sont pas autorisées. Le champ Max retry duration n'accepte que les valeurs h, m et s. Min backoff duration et Max backoff duration sont compatibles avec l'ensemble complet.

  12. Pour les cibles HTTP HTTP et App Engine, vous pouvez éventuellement configurer un pour les tentatives de job. Si le gestionnaire de requêtes ne répond pas délai, la requête est annulée et la tentative est marquée comme ayant échoué. Cloud Scheduler relance le job en fonction de la configuration des nouvelles tentatives.

  13. Pour créer et enregistrer le job, cliquez sur Créer.

    La tâche sera désormais exécutée à la fréquence spécifiée.

gcloud

Lorsque vous créez un job à l'aide de gcloud CLI, vous devez utiliser des commandes différentes pour chaque type de cible :

HTTP

Vous pouvez envoyer une requête à n’importe quel point de terminaison HTTP ou HTTPS. Les points de terminaison HTTP ciblés doivent être accessibles au public.

gcloud scheduler jobs create http JOB \
    --location=LOCATION \
    --schedule=SCHEDULE \
    --uri=URI

Remplacez les éléments suivants :

  • JOB: nom de job qui doit être unique dans le projet. Notez que vous ne pouvez pas réutiliser un nom de job dans un projet, même si vous supprimer le job associé.

  • LOCATION: emplacement d'exécution de votre job.

  • SCHEDULE: fréquence ou intervalle du job auquel le job doit s'exécuter (par exemple, every 3 hours). La que vous indiquez ici peut être tout type unix-cron chaîne compatible. Bien que nous ne recommandions plus son utilisation, l'ancienne version Syntaxe Cron d'App Engine est toujours compatible avec les jobs existants.

    Pour en savoir plus, consultez Configurer des job Cron Cron.

  • URI : URI complet du point de terminaison que le job doit contacter.

D'autres paramètres sont décrits dans la documentation de référence de la ligne de commande gcloud :

  • Vous pouvez éventuellement spécifier la méthode HTTP. La valeur par défaut est