Programación cron segura para la zona horaria sin trabajos perdidos

Horario-Seguro de Programación Cron sin Tareas Perdidas

Las expresiones cron no tienen un campo de horario. Se ejecutan en el horario en el que se encuentra configurado el servidor (o el programador) -- generalmente UTC. Esto causa incidentes de producción reales cuando los desarrolladores asumen el horario local.

La Trampa Clásica

Quieres un informe diario a las 9:00 AM hora de Nueva York. Escribe:

0 9 * * *

Pero el servidor corre en UTC. Esto dispara a las 9:00 AM UTC = 4:00 AM EST (invierno) o 5:00 AM EDT (verano). Tu informe llega antes de que alguien esté despierto, y el tiempo cambia con el horario de verano.

El Problema del Horario de Verano

El horario de verano crea dos modos de falla específicos:

Avanzar hacia la primavera (2:00 AM → 3:00 AM): Una tarea programada en 0 2 * * * nunca se ejecuta esa noche. La hora de 2:00 AM no existe.

Retroceder hacia el otoño (2:00 AM → 1:00 AM): Una tarea programada en 0 1 * * * se ejecuta dos veces. La hora de 1:00 AM ocurre dos veces.

Esto afecta a EE. UU., la UE y ~70 otros países. Si tu tarea cron es idempotente, los doble-runs son inocuos. Si envía correos electrónicos o cobra tarjetas de crédito -- tienes un problema.

Soluciones

1. Almacena y Ejecuta siempre en UTC

La solución más simple: establece todas las expresiones cron en UTC y convierte para la visualización.

# 9:00 AM ET = 14:00 UTC (durante EST) o 13:00 UTC (durante EDT)
# Elige uno y acepta un desfase de 1 hora, o mantiene dos expresiones
0 14 * * *

2. Utiliza CRON_TZ (Soportado por systemd, Kubernetes, muchos programadores)

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

# CronJob de Kubernetes
apiVersion: batch/v1
kind: CronJob
metadata:
  name: informe-diario
spec:
  schedule: "CRON_TZ=America/New_York 0 9 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: informe
            image: informe-ejecutor:último

3. Utiliza Nombres de Zonas Horarias de IANA, Nunca Offsets

# BIEN
CRON_TZ=America/New_York
CRON_TZ=Europa/Berlín

# MAL -- no maneja el horario de verano
CRON_TZ=EST         # siempre -5, ignora EDT
CRON_TZ=UTC-5       # mismo problema

4. Evita la Ventana de 1:00-3:00 AM

Si no puedes utilizar CRON_TZ, programa tareas fuera de la ventana de transición del horario de verano (1:00-3:00 AM local). Las tareas a las 4:00 AM local o más tarde son seguras.

Verifica Antes de Desplegar

Pega tu expresión cron en el Validador de Cron para ver las próximas 5-10 veces de disparo y confirmar que se alinean con tus expectativas. Revisa tanto enero (tiempo estándar) como julio (horario de verano) fechas.

Relacionado

Términos técnicos