Programación y Cron

Los scripts de Python se convierten en trabajos fiables cuando se programan con cron del sistema, temporizadores de systemd o programadores dentro del proceso como APScheduler. El script en sí debe ser idempotente, registrarse y salir con códigos significativos.

Receta

# crontab -e
0 2 * * * cd /opt/jobs && /opt/jobs/.venv/bin/python backup.py >>/var/log/backup.log 2>&1

from apscheduler.schedulers.blocking import BlockingScheduler
 
sched = BlockingScheduler()
sched.add_job(lambda: print("tick"), "interval", minutes=5)
sched.start()

Cuándo recurrir a esto:

• ETL nocturno y generación de informes
• Comprobaciones de rotación de certificados y registros
• Consultas a APIs cuando los webhooks no están disponibles
• Agente de desarrollo/larga duración con APScheduler en un solo proceso

Ejemplo funcional

Script compatible con cron con archivo de bloqueo, registro y alternativa APScheduler para desarrollo.

import fcntl
import logging
import sys
from contextlib import contextmanager
from pathlib import Path
 
LOCK = Path("/tmp/daily-sync.lock")
logging.basicConfig(level=logging.INFO, format="%(asctime)s %(message)s")
log = logging.getLogger("daily-sync")
 
@contextmanager
def single_instance(lock_path: Path):
    lock_path.parent.mkdir(parents=True, exist_ok=True)
    with lock_path.open("w") as f:
        try:
            fcntl.flock(f.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB)
        except BlockingIOError:
            log.warning("otra instancia en ejecución")
            raise SystemExit(0)
        yield
 
def job() -> int:
    log.info("inicio de sincronización")
    # ... trabajo ...
    log.info("sincronización completada")
    return 0
 
def main() -> int:
    with single_instance(LOCK):
        return job()
 
if __name__ == "__main__":
    raise SystemExit(main())

Lo que esto demuestra:

• El bloqueo de archivos evita invocaciones de cron superpuestas cuando el trabajo excede el intervalo
• Salida 0 al omitir la ejecución duplicada; cron no alerta falsamente
• Las rutas absolutas al python del venv en crontab evitan el intérprete incorrecto

Inmersión Profunda

Opciones del Programador

Higiene de Cron

• Establecer PATH y cd a la raíz del proyecto
• Usar la ruta absoluta de python del venv
• Redirigir stdout/stderr a registros rotados
• Monitorizar la marca de tiempo del último éxito externamente

Notas de Python

from apscheduler.schedulers.background import BackgroundScheduler
 
scheduler = BackgroundScheduler()
scheduler.add_job(send_heartbeat, "cron", hour=3)
scheduler.start()  # no bloqueante en aplicaciones web - apagar al salir

Errores Comunes

• Rutas relativas en cron - archivo no encontrado. Solución: cd al directorio de la aplicación o rutas absolutas en todas partes.
• Ejecuciones superpuestas - doble procesamiento. Solución: flock o bloqueo distribuido (Redis/DynamoDB).
• Fallo silencioso de cron - registro vacío significa éxito incluso si falla antes de registrarse. Solución: envolver try/except de nivel superior, enviar correo electrónico en caso de salida no cero.
• APScheduler en Gunicorn con múltiples trabajadores - trabajos duplicados. Solución: solo el programador en un proceso dedicado o usar cron del SO.
• Sorpresas con la zona horaria - cron usa la TZ del servidor. Solución: documentar UTC vs local; usar TZ= en crontab si es necesario.

Alternativas

Preguntas Frecuentes

Relacionado

• Scripts Robustos - bloqueos y códigos de salida
• Conceptos Básicos de Scripting - punto de entrada CLI
• Trabajar con APIs y Webhooks - alternativa de sondeo
• Mejores Prácticas de Scripting del Sistema - operaciones desatendidas
• Prefect y Dagster - orquestación de flujos de trabajo a escala

Versiones de la pila: Esta página se escribió para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ y uv 0.6+.