Bezpieczne dla strefy czasowej planowanie Cron bez opuszczonych zadań

Zabezpieczenie Synchronizacji Cron Bez Przegłosów

Wyrażenia cron nie posiadają pola czasu strefy. Uruchamiają się w czasie strefie serwera (lub scheduler) - zazwyczaj UTC. Powoduje to realne incydenty produkcyjne, gdy deweloperzy założą lokalny czas.

Klasyczne Pułapki

Chcesz otrzymać dzienny raport o godzinie 9:00 rano czasu Nowojorskiego. Piszesz:

0 9 * * *

Ale serwer uruchamia się w czasie UTC. To uruchamia się o 9:00 rano UTC = 4:00 rano EST (zimowy) lub 5:00 rano EDT (letni). Twój raport przychodzi przed wczesnym poranem, a czas zmienia się wraz z DST.

Problem DST

Czas letni stwarza dwa specyficzne tryby błędów:

Wiosenne przesunięcie (2:00 rano → 3:00 rano): Zadanie zaplanowane na 0 2 * * * nie uruchamia się w tej nocy. Godzina 2:00 nie istnieje.

Zimowe przesunięcie (2:00 rano → 1:00 rano): Zadanie zaplanowane na 0 1 * * * uruchamia się dwukrotnie. Godzina 1:00 występuje dwukrotnie.

To dotyczy USA, UE i około 70 innych krajów. Jeśli Twoje zadanie cron jest idempotentne, podwójne uruchamianie jest bez szkody. Jeśli wysyła wiadomości e-mail lub nalicza kartę kredytową - masz problem.

Rozwiązania

1. Zawsze Zapisuj i Uruchamiaj w UTC

Najprostsze rozwiązanie: ustaw wszystkie wyrażenia cron w czasie UTC i przekonwertuj na wyświetlanie.

# 9:00 rano ET = 14:00 UTC (podczas EST) lub 13:00 UTC (podczas EDT)
# Wybierz jedną i zaakceptuj 1-godzinny przesunięcie, lub utrzymuj dwa wyrażenia
0 14 * * *

2. Użyj CRON_TZ (Obsługiwane przez systemd, Kubernetes, wiele schedulerów)

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

# Kubernetes CronJob
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. Użyj Nazw Czasu Strefy IANA, nigdy Offsetów

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

# Złe - nie obsługuje DST
CRON_TZ=EST         # zawsze -5, ignoruje EDT
CRON_TZ=UTC-5       # ten sam problem

4. Unikaj Okna 1:00-3:00 rano

Jeśli nie możesz użyć CRON_TZ, zaplanuj zadania poza oknem przejścia DST (1:00-3:00 rano lokalne). Zadania o godzinie 4:00 rano lokalne lub późniejsze są bezpieczne.

Weryfikuj Przed Wdrożeniem

Wklej swoje wyrażenie cron do Weryfikatora Cron i sprawdź, czy następne 5-10 uruchomienia są zgodne z Twoimi oczekiwaniami. Sprawdź oba styczeń (czas standardowy) i lipiec (czas letni) daty.

Powiązane