Planification Cron sécurisée par fuseau horaire sans tâches manquées

Planification de tâches Cron sans décalage horaire

Les expressions Cron n'ont pas de champ de fuseau horaire. Elles s'exécutent dans le fuseau horaire du serveur (ou du planificateur) -- généralement UTC. Cela cause des incidents réels en production lorsque les développeurs supposent l'heure locale.

Le piège classique

Vous voulez un rapport quotidien à 9:00 AM heure de New York. Vous écrivez :

0 9 * * *

Mais le serveur fonctionne en UTC. Cela déclenche à 9:00 AM UTC = 4:00 AM EST (hiver) ou 5:00 AM EDT (été). Votre rapport arrive avant que quiconque soit réveillé, et l'heure change avec l'heure d'été.

Le problème de l'heure d'été

L'heure d'été crée deux modes de défaillance spécifiques :

Passage à l'heure d'été (2:00 AM → 3:00 AM) : Une tâche planifiée à 0 2 * * * ne s'exécute jamais cette nuit-là. L'heure 2:00 AM n'existe pas.

Retour à l'heure normale (2:00 AM → 1:00 AM) : Une tâche planifiée à 0 1 * * * s'exécute deux fois. L'heure 1:00 AM se produit deux fois.

Cela affecte les États-Unis, l'UE et environ 70 autres pays. Si votre tâche Cron est idempotente, les exécutions doubles sont inoffensives. Si elle envoie des e-mails ou facture des cartes de crédit -- vous avez un problème.

Solutions

1. Toujours stocker et exécuter en UTC

La solution la plus simple : définir toutes les expressions Cron en UTC et convertir pour l'affichage.

# 9:00 AM ET = 14:00 UTC (pendant l'EST) ou 13:00 UTC (pendant l'EDT)
# Choisissez l'une et acceptez un décalage d'une heure, ou maintenez deux expressions
0 14 * * *

2. Utiliser CRON_TZ (supporté par systemd, Kubernetes, de nombreux planificateurs)

# Timer systemd
CRON_TZ=America/New_York
0 9 * * *

# CronJob Kubernetes
apiVersion: batch/v1
kind: CronJob
metadata:
  name: daily-report
spec:
  schedule: "CRON_TZ=America/New_York 0 9 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: report
            image: report-runner:latest

3. Utiliser les noms de fuseaux horaires IANA, jamais les décalages

# BON
CRON_TZ=America/New_York
CRON_TZ=Europe/Berlin

# MAUVAIS -- ne gère pas l'heure d'été
CRON_TZ=EST         # toujours -5, ignore l'EDT
CRON_TZ=UTC-5       # même problème

4. Éviter la fenêtre de 1:00 à 3:00 AM

Si vous ne pouvez pas utiliser CRON_TZ, planifiez les tâches en dehors de la fenêtre de transition de l'heure d'été (1:00-3:00 AM locale). Les tâches à 4:00 AM local ou plus tard sont sûres.

Vérifiez avant de déployer

Collez votre expression Cron dans le Vérificateur Cron pour voir les 5-10 prochaines heures de déclenchement et confirmer qu'elles correspondent à vos attentes. Vérifiez les dates de janvier (heure normale) et de juillet (heure d'été).

Liens connexes