Décodeur Cron : traduire une expression Cron en ligne

TL;DR (Réponses cron rapides)

• Cron expression (Unix) : minute hour day-of-month month day-of-week → 5 champs.
• Variantes Quartz/Spring : souvent 6 ou 7 champs (ajout des seconds, parfois year) et le wildcard spécial **? ** pour no specific value dans DOM/DOW.
• Kubernetes CronJob : spec.schedule utilise le format cron standard ; les clusters modernes supportent spec.timeZone pour des plannings à l’heure locale.
• Bonne pratique : Toujours tester & monitorer tes cron jobs ; journalise les sorties et configure des alertes en cas d’échec.

C’est quoi Cron ?

Cron est un planificateur de tâches basé sur le temps dans les systèmes de type Unix. Il exécute des commandes à des intervalles définis via des cron expressions. Chaque ligne dans ton crontab déclare quand et quoi exécuter.

Où tourne cron :

• System crontab : /etc/crontab (contient un champ utilisateur)
• User crontab : crontab -e par utilisateur

Des chaînes prédéfinies comme @hourly, @daily, @weekly, @monthly, @reboot sont des raccourcis que tu peux utiliser à la place d’expressions complètes.

Syntaxe des cron expressions (Unix / style POSIX)

Format (5 champs) :

┌───────────── minute (0–59)
│ ┌─────────── hour (0–23)
│ │ ┌───────── day of month (1–31)
│ │ │ ┌─────── month (1–12 or JAN–DEC)
│ │ │ │ ┌───── day of week (0–6 or SUN–SAT; 0 or 7 = Sunday on many systems)
│ │ │ │ │
│ │ │ │ │
* * * * *

Wildcards & opérateurs

• * any value
• , list → 1,2,5
• - range → 1-5
• / step → */10
• L, W, # sont des extensions non standard (souvent supportées par Quartz, pas par le cron Unix classique).

Exemples

• Toutes les 15 minutes : */15 * * * *
• Tous les jours à 02:00 : 0 2 * * *
• En semaine à 18:30 : 30 18 * * 1-5
• Premier jour du mois à 07:00 : 0 7 1 * *

Astuce portabilité : Évite de dépendre de modificateurs non standard sauf si ton scheduler les documente. Le cron Unix classique n’accepte pas ?, L, W ou #.

Quartz Cron / Spring Cron vs Unix Cron (les différences à connaître)

De nombreux planificateurs applicatifs (p. ex. Quartz, Spring) adoptent une syntaxe étendue :

• Champs : seconds minutes hours day-of-month month day-of-week [year] → 6 ou 7 champs
• Spécial ? : utilisé dans day-of-month ou day-of-week pour signifier no specific value
• Des modificateurs étendus comme L (last), W (weekday), # (nth weekday) sont souvent supportés.

Mapping rapide

• Unix : 0 2 * * * → tous les jours à 02:00
• Quartz/Spring (avec seconds) : 0 0 2 * * ? → tous les jours à 02:00 (aucun DOW spécifique)

Pièges fréquents

• Coller une expression à 5 champs d’Unix dans Spring/Quartz ne marchera pas. Ajoute seconds (et parfois year) ou utilise un helper pour convertir.
• ? est invalide en Unix cron mais requis dans certains scénarios Quartz.

Kubernetes CronJobs (k8s)

• Définis les plannings via spec.schedule (format cron standard).
• Les versions récentes de Kubernetes supportent spec.timeZone, ce qui permet d’épingler un fuseau horaire IANA (par ex. "Europe/Zurich"). Sans cela, les plannings sont évalués selon l’heure locale du controller (souvent UTC).

Exemple

apiVersion: batch/v1
kind: CronJob
metadata:
  name: db-backup
spec:
  schedule: '0 2 * * *' # 02:00 tous les jours
  timeZone: 'Europe/Zurich' # garantit un planning à l’heure locale (supporté sur les clusters modernes)
  successfulJobsHistoryLimit: 3
  failedJobsHistoryLimit: 1
  jobTemplate:
    spec:
      template:
        spec:
          restartPolicy: OnFailure
          containers:
            - name: backup
              image: alpine:3.20
              command: [ 'sh', '-lc', 'pg_dump $DB_URL > /backups/$(date +%F).sql' ]

Générateur / Décodeur de cron expressions (inline)

Utilise le générateur d’expressions Cron pour créer un planning, ou colle un planning existant dans le décodeur Cron afin d’obtenir une explication claire et les prochaines exécutions.

Modèles rapides

Aide au décodage

• Tout */N → exécute toutes les N unités de ce champ.
• DOM et DOW tous deux définis → le comportement varie selon l’implémentation ; reste sur un seul (ou utilise ? avec Quartz).

Bases de crontab

• Éditer : crontab -e
• Lister : crontab -l
• Environnement : définis PATH, SHELL, MAILTO et tes variables explicitement - cron tourne avec un environnement minimal.
• Sortie : capture avec >> /var/log/myjob.log 2>&1 ou compte sur le mail système.

Checklist de debug cron

1. La commande est-elle exécutable en tant que même utilisateur ?
2. Les chemins absolus sont-ils utilisés pour les binaires et les fichiers ?
3. L’environnement (PATH, LANG, TZ) est-il défini ?
4. L’expression est-elle valide pour la saveur de ton scheduler ?
5. Les échecs sont-ils monitorés/alertés ?

Monitoring & fiabilité

• Redirige les sorties vers des logs et alerte si les codes de retour ≠ 0.
• Pense à des moniteurs dédiés (health pings, heartbeats) qui alertent quand des exécutions manquent.
• Dans Kubernetes, surveille les statuts des Job, règle backoffLimit et conserve un peu d’historique.

Cron FAQs

Cron Checklist

1. Identifie la saveur de scheduler (Unix, systemd timer, Quartz/Spring, k8s).
2. Normalise les expressions à cette saveur (5 vs 6/7 champs, symboles spéciaux).
3. Épingle le fuseau horaire et clarifie le comportement DST.
4. Ajoute du monitoring (heartbeat + alertes d’échec).
5. Documente la responsabilité, les runbooks et les chemins d’escalade.