MemoriaGCP

tekio.org

Cloud Scheduler

Projet GCPCloud Scheduler0 6 * * 1-5Job Cloud Runtraitement de nuitPub/Subsujet de déclenchementWorkflowsenchaînement d'appelsService abonnéCloud Run12345
  1. À l'heure prévue, le planificateur appelle l'API d'administration de Cloud Run, muni d'un jeton OIDC, pour lancer un job.
  2. Une autre tâche se contente de publier un message sur un sujet Pub/Sub, avec une charge utile fixe.
  3. Le service abonné consomme le message et fait le travail, sans rien savoir de l'horloge.
  4. Une troisième tâche crée une exécution de workflow, quand le traitement demande plusieurs appels enchaînés.
  5. Une exécution qui ne renvoie pas de succès est réessayée selon la politique de la tâche : nombre de tentatives et délai exponentiel.

Ce que c'est

Planificateur managé : l'équivalent de cron, mais sans machine à maintenir et avec des réessais. Une tâche associe un horaire à une cible ; à chaque échéance, Cloud Scheduler déclenche une exécution.

  • Horaire. Format unix-cron à cinq champs — minute, heure, jour du mois, mois, jour de la semaine — avec un fuseau horaire explicite, donc un passage à l'heure d'été correctement géré. Une syntaxe plus lisible (every 5 minutes, every monday 09:00) est également acceptée.
  • Trois types de cible. Un point d'entrée HTTP ou HTTPS, avec méthode, en-têtes et corps de requête ; un sujet Pub/Sub, où la tâche publie un message fixe ; une application App Engine du même projet. Pour une cible HTTP, le planificateur joint un jeton OIDC ou OAuth émis par un compte de service, ce qui suffit à appeler un service Cloud Run privé ou une API Google Cloud.
  • Réessais. Une exécution sans acquittement est réessayée selon la politique de la tâche : nombre maximal de tentatives, durée maximale de réessai, délai minimal et maximal, nombre de doublements. La livraison est au moins une fois — une même échéance peut donner deux exécutions, donc la cible doit être idempotente. L'en-tête X-CloudScheduler-ScheduleTime, constant d'une tentative à l'autre, sert justement à dédupliquer.
  • Limites. 5 000 tâches par région, charge utile de 1 Mo, et 30 minutes au plus pour une exécution à cible HTTP, au-delà desquelles la tentative est considérée en échec puis réessayée.
  • Facturation à la tâche et non à l'exécution : 0,10 $ par tâche et par tranche de 31 jours, au prorata des jours. Chaque compte de facturation dispose de 3 tâches gratuites par mois — mesurées au niveau du compte, pas du projet. Une tâche en pause reste comptée.

Passer par un sujet Pub/Sub plutôt que d'appeler directement le service découple l'horaire du consommateur : on peut changer, dupliquer ou mettre en attente le traitement sans toucher à la tâche planifiée.

À quoi ça sert

  • Lancer un traitement récurrent : rapport quotidien, purge de données, rafraîchissement d'un cache, synchronisation avec un système tiers.
  • Démarrer un job Cloud Run ou une exécution Workflows à heure fixe, sans écrire le moindre code de planification.
  • Réveiller périodiquement un service qui descend à zéro, ou sonder une ressource externe à intervalle régulier.
  • Remplacer les crontab dispersées sur des VM par une planification déclarative, versionnée et visible dans la console.

À éviter dès que l'horaire dépend d'un calcul, d'un calendrier métier ou de l'état d'une exécution précédente : il n'y a ni dépendance entre tâches, ni rattrapage des occurrences manquées, ni vue de l'historique au-delà des journaux. Un orchestrateur comme Airflow ou un workflow qui boucle convient mieux. À éviter aussi pour différer un travail unique déclenché par l'application : c'est le rôle d'une tâche datée dans Cloud Tasks.

Alternatives en logiciel libre

  • cron et anacron : l'original, sur n'importe quelle machine Unix ; même syntaxe d'horaire, mais aucun réessai ni journal centralisé.
  • Timers systemd (LGPL 2.1) : planification intégrée à la gestion des services, avec horaires calendaires, rattrapage des occurrences manquées et journal.
  • CronJob Kubernetes (Apache 2.0) : le même modèle dans un cluster, chaque occurrence créant un Job isolé, avec politique de réessai et historique.
  • Cronicle (MIT) : ordonnanceur distribué avec interface web, catalogue de tâches, journaux et alertes.
  • Apache Airflow (Apache 2.0) : quand la planification s'accompagne de dépendances entre traitements et de rattrapage.

Documentation