Générateur et explication d’expressions cron

Qu’est-ce qu’une expression cron ?

Cron est le planificateur présent sur presque tous les serveurs Linux et Unix. Vous lui donnez une ligne avec une planification et une commande, et cron exécute cette commande aux moments décrits par la planification : une sauvegarde chaque nuit, une synchronisation tous les quarts d’heure, un rapport chaque lundi matin. Le même format de planification est utilisé par GitHub Actions, les CronJobs Kubernetes, Vercel, Laravel, Coolify et bien d’autres plateformes.

La planification, c’est l’expression cron : cinq champs séparés par des espaces. Cette notation étant très compacte, elle ne se lit pas facilement d’un coup d’œil. Avec ce générateur d’expressions cron, vous collez une expression et voyez aussitôt, en français clair, quand elle s’exécute, ainsi que les cinq prochaines exécutions dans votre propre fuseau horaire. Dans l’autre sens, vous faites un choix pour chaque champ et l’outil construit l’expression pour vous. Les deux côtés restent synchronisés : modifiez le texte et le générateur suit, et inversement.

Les cinq champs d’une expression cron

Les champs apparaissent toujours dans le même ordre. Minute : 0 à 59. Heure : 0 à 23, au format 24 heures. Jour du mois : 1 à 31. Mois : 1 à 12, ou JAN à DEC. Jour de la semaine : 0 à 7, 0 et 7 désignant tous deux le dimanche, ou SUN à SAT. Les noms ne tiennent pas compte de la casse.

Chaque champ s’appuie sur quelques éléments de base. Un astérisque (*) signifie toutes les valeurs. Une virgule crée une liste, comme 1,15 pour le 1er et le 15. Un tiret crée une plage, comme 1-5 pour du lundi au vendredi. Une barre oblique définit un pas : */15 dans le champ des minutes signifie toutes les 15 minutes, 10-30/5 correspond aux minutes 10, 15, 20, 25 et 30. La plupart des implémentations de cron acceptent aussi des macros : @hourly, @daily (ou @midnight), @weekly, @monthly et @yearly (ou @annually).

Quelques exemples. 30 8 * * 1-5 s’exécute à 08:30 les jours de semaine. 0 0 1 * * s’exécute à minuit le premier jour de chaque mois. */10 9-17 * * * s’exécute toutes les dix minutes entre 09:00 et 17:59. 0 3 * * 0 s’exécute chaque dimanche à 03:00, un horaire prisé pour les tâches de maintenance.

Erreurs fréquentes avec cron

L’erreur la plus fréquente concerne le fuseau horaire. Les serveurs et les conteneurs tournent souvent en UTC, alors que vous raisonnez en heure locale. Sur un tel serveur, aux Pays-Bas, une tâche réglée sur 0 8 * * * s’exécute à 10:00 heure locale en été et à 09:00 en hiver. Vérifiez donc toujours quel fuseau horaire utilise le démon cron ou la plateforme. Cet outil affiche les exécutions dans le fuseau horaire de votre navigateur ; si votre serveur tourne en UTC, faites la conversion. Autour du passage à l’heure d’été ou d’hiver, une tâche entre 02:00 et 03:00 peut être sautée ou se déclencher deux fois. Planifiez les tâches importantes en dehors de cette heure.

Deuxième piège : le jour du mois et le jour de la semaine renseignés ensemble. Si vous remplissez les deux, cron s’exécute dès que l’un des deux correspond, et pas seulement quand ils coïncident. 0 9 13 * 5 signifie donc chaque 13 du mois et chaque vendredi, et pas uniquement le vendredi 13. Si vous avez vraiment besoin de cette combinaison, laissez l’un des champs sur * et vérifiez l’autre condition dans votre script.

Nous voyons aussi souvent des expressions à six champs. Elles viennent de Quartz (Java), de Spring ou de node-cron, où un champ des secondes vient en premier et parfois un champ de l’année en dernier. Quartz connaît en outre des caractères comme ?, L, W et #. Cet outil prend volontairement en charge la notation standard à 5 champs utilisée par cron, GitHub Actions et Kubernetes, et affiche un message clair si vous collez une expression à 6 champs ou de type Quartz. Enfin, méfiez-vous des dates impossibles : 0 0 30 2 * ne s’exécute jamais, car février n’a pas de 30.

Quand cron ne suffit plus

Cron est idéal pour quelques tâches indépendantes sur un seul serveur. Cela se complique lorsque les tâches dépendent les unes des autres, que vous voulez savoir si une tâche a réussi, ou qu’une exécution échouée doit être relancée automatiquement. Par défaut, cron envoie tout au plus un e-mail avec la sortie, et si le serveur est arrêté, une exécution manquée n’est pas rattrapée.

Vous faites tourner des dizaines de tâches planifiées sur plusieurs serveurs, avec des intégrations vers votre logiciel comptable, votre CRM ou votre boutique en ligne ? Une plateforme de workflow ou d’automatisation est alors souvent le meilleur choix. Une telle plateforme planifie les tâches avec la même notation cron, mais y ajoute journalisation, supervision, relances, dépendances et alertes en cas d’échec. Vous voyez dans une seule vue ce qui tourne et ce qui a échoué, sans que personne ait à se connecter au serveur.