De cron a los temporizadores de systemd

Migrar un trabajo de cron a un temporizador de systemd es reescribir una línea de cron de cinco campos como una unidad .timer cuya expresión OnCalendar dice cuándo debe ejecutarse la unidad .service correspondiente, y luego demostrar que ambos horarios coinciden antes de borrar la línea de cron. La conversión parece mecánica: minutos y horas se corresponden directamente, los meses también, y la mayoría de los horarios simples se traducen sin problemas. El problema es que los dos planificadores no entienden lo mismo por un horario de aspecto idéntico, y los puntos en los que difieren son justo los que una mirada no detecta: un día del mes combinado con un día de la semana, una ejecución dentro del hueco del cambio de hora de primavera, un trabajo mensual el día 31. Puedes convertir y demostrar ambos lados en el conversor de cron a temporizador de systemd, que calcula las próximas 100 ejecuciones de cada uno y marca dónde discrepan, todo en tu navegador.

Por qué los equipos abandonan cron, y por qué cron sigue valiendo para trabajos simples

Cron es el planificador más antiguo de Unix, y sus límites son las razones por las que los equipos lo abandonan. Un trabajo de cron no puede esperar a que otro servicio esté listo: si el trabajo necesita la base de datos activa, se ejecuta igualmente y falla, porque cron no tiene orden de dependencias. Su salida va al correo local o a ninguna parte, así que un trabajo que falla en silencio sigue fallando en silencio: no hay journal que consultar ni estado que comprobar. Su calendario tiene cinco campos, así que no hay forma de decir "el primer lunes del mes" o "el último día de febrero", y una máquina apagada o dormida en el minuto programado simplemente pierde esa ejecución. Un temporizador de systemd corrige cada uno de esos puntos: dependencias con After= y Requires=, cada disparo registrado en el journal como cualquier otra unidad, una recuperación con Persistent= para las ejecuciones perdidas y una expresión OnCalendar con nombres de días de semana, rangos de fechas y sintaxis de último día del mes.

Nada de eso significa que cron esté obsoleto, y migrar un trabajo que funciona solo porque los temporizadores son más nuevos es un error. Cron sigue siendo la herramienta adecuada para un trabajo simple por usuario, para un horario que lleva una década sin cambiar y para cualquier sistema sin systemd: contenedores, imágenes mínimas, hosts BSD y macOS. La prueba no es qué planificador es más nuevo, sino qué necesita el trabajo: si necesita orden, registro, recuperación tras una parada o un calendario que cron no puede expresar, migralo. Si es un horario de una línea que nunca ha fallado y que nadie ha tenido que depurar jamás, déjalo en paz. Una migración que no compra nada es riesgo sin retorno, y este artículo trata de las migraciones que sí compran algo, hechas de forma que no puedan cambiar en silencio cuándo se ejecuta el trabajo.

La trampa DOM+DOW: el único error de migración que duplica las ejecuciones en silencio

La línea más peligrosa de una migración de cron es la que restringe a la vez el día del mes y el día de la semana, y el ejemplo clásico es 0 0 15 * 5. La mayoría lo lee como "medianoche del viernes 15". Eso no es lo que significa. La página del manual crontab(5) enuncia la regla sin rodeos: si ambos campos de día están restringidos, es decir, ninguno contiene "*", el comando se ejecuta cuando cualquiera de los dos campos coincide. Así que 0 0 15 * 5 se dispara a medianoche el día 15 de cada mes y todos los viernes, unas cinco veces al mes en lugar de una, y lleva haciéndolo desde que existe la línea. Quien lo convierte en una sola línea OnCalendar acaba de cambiar el horario sin saberlo.

OnCalendar significa lo contrario. La página del manual systemd.time(7) da el ejemplo Thu,Fri 2012-*-1,5 y dice que se refiere al primer o quinto día del mes, "pero solo si ese día es jueves o viernes": la fecha y el día de la semana deben coincidir ambos. Así que la conversión ingenua Fri *-*-15 00:00 solo se dispara cuando el 15 cae realmente en viernes, unas pocas veces al año, y las ejecuciones de los viernes y la mayoría de las del día 15 desaparecen en silencio. La conversión correcta son dos líneas OnCalendar en una sola unidad .timer, *-*-15 00:00 y Fri *-*-* 00:00, porque la página del manual systemd.timer(5) permite especificar OnCalendar más de una vez, y la unidad se dispara cuando cualquiera de sus expresiones vence. Esa unión es el sentido del conversor: emite ambas líneas y marca la entrada como unión, en lugar de emitir una sola línea que cambia el horario en silencio.

Horario de verano y fin de mes: donde los dos planificadores discrepan de verdad

El horario de verano es el punto en el que los dos planificadores dejan de coincidir incluso en principio, y las páginas del manual son honestas sobre esa asimetría. Para cron, crontab(5) enuncia la regla explícitamente: las horas inexistentes, como las "horas perdidas" del cambio de primavera, nunca coinciden, así que un trabajo programado a las 02:30 ese día simplemente no se ejecuta, y las horas que ocurren dos veces, en el cambio de otoño, hacen que los trabajos coincidentes se ejecuten dos veces. Para los temporizadores, las páginas del manual de systemd no enuncian ninguna regla equivalente: systemd.time(7) y systemd.timer(5) describen la sintaxis del calendario en detalle, pero ninguna de las dos dice qué hace un disparo OnCalendar dentro de la hora perdida. Ese silencio es un hecho, no una omisión que deba rellenarse adivinando, y este artículo no inventará una regla que las páginas del manual no enuncian.

El fin de mes es la misma historia en miniatura. Una línea de cron para el día 31 simplemente se salta cada mes que no tiene 31 días, y OnCalendar hace lo mismo por defecto, pero OnCalendar también ofrece sintaxis que cron no puede expresar en absoluto, como la forma de último día con "~": *-02~01 significa el último día de febrero, y Mon *-05~07/1 significa el último lunes de mayo. La consecuencia práctica es sencilla: mantén los trabajos sensibles a la hora fuera de las 02:00–03:00 si puedes, y si no puedes, genera la tabla de las próximas 100 ejecuciones cruzando un cambio de horario y un fin de mes, y léela en lugar de adivinar. Donde las páginas del manual callan, la tabla es la única respuesta honesta: ejecútala, no des nada por supuesto. Lo mismo vale para AccuracySec: los temporizadores no se disparan necesariamente en el segundo exacto configurado, así que un horario que depende de segundos exactos necesita otro diseño, no una expresión más ajustada.

El flujo de demostración: compara las próximas 100 ejecuciones antes de cambiar

El flujo de demostración es corto, y saltárselo es como un error de migración llega a producción. Convierte la línea de cron y luego calcula las próximas 100 ejecuciones de ambos lados desde la misma hora de inicio y en la misma zona horaria, lado a lado, y lee el veredicto sobre las 100 completas, no sobre las primeras. Una divergencia mensual puede no aparecer en las primeras diez filas, y una divergencia de horario de verano no aparecerá en absoluto a menos que la ventana cruce un cambio de hora, y por eso la tabla llega hasta 100 ejecuciones y no 10. El conversor calcula ambas tablas en tu navegador y resalta las primeras filas en las que difieren; systemd-analyze calendar valida una expresión OnCalendar cada vez, lo que sirve para comprobar la mitad del temporizador, pero no puede comparar las dos mitades por ti.

La segunda mitad del flujo es una pista para la siguiente persona. Mantén la línea original de cron como comentario en el archivo .timer o .service, junto a las líneas OnCalendar que la sustituyeron, para que quien lea la unidad pueda ver qué sustituyó y por qué hay dos líneas en lugar de una. Una conversión sin su línea de origen es un horario que nadie puede auditar: seis meses después, nadie recordará si la segunda línea OnCalendar fue deliberada o un resto, y la tentación será "limpiarla", que es como las ejecuciones de los viernes desaparecen por segunda vez. La línea de cron comentada cuesta una línea y responde a la pregunta antes de que se formule.

La ruta segura de migración: drop-ins, Persistent y el hueco de @reboot

Nunca edites a mano un archivo de unidad empaquetado en /usr/lib/systemd/system: la siguiente actualización del paquete lo sobrescribe, y la migración desaparece en silencio junto con el endurecimiento. La ruta admitida es un drop-in: ejecuta systemctl edit myjob.timer y tus cambios caen en /etc/systemd/system/myjob.timer.d/override.conf, donde tienen prioridad sobre el archivo distribuido, sobreviven a las actualizaciones y se pueden eliminar borrando un archivo. Después recarga, habilita el temporizador y confirma que está realmente armado con systemctl list-timers, que muestra la próxima hora de disparo: el único número que te dice si la conversión produjo el horario que querías.

Dos ajustes merecen una decisión deliberada y no un valor por defecto. Persistent=true es la elección correcta para portátiles y equipos de escritorio que duermen: si la máquina estaba apagada cuando vencía un disparo, el servicio se ejecuta una vez en la siguiente oportunidad en lugar de que esa ejecución no ocurra nunca en silencio; ten en cuenta que es una única recuperación, no una repetición de todas las ejecuciones perdidas, y que solo se aplica a temporizadores OnCalendar. Y @reboot no tiene un equivalente real en temporizadores: OnBootSec=, que se dispara un tiempo fijo después del arranque, es el análogo más cercano, y no es idéntico: es relativo al arranque y no "ejecutar una vez al inicio", y en contenedores se corresponde con OnStartupSec=. Si el trabajo debe ejecutarse exactamente una vez por arranque, OnBootSec= es la respuesta, pero documenta la diferencia en la unidad; no finjas que la conversión es exacta cuando la página del manual dice lo contrario.

El hábito de auditar primero: convierte, demuestra, ejecuta en paralelo y luego cambia

El cambio más seguro es aburrido a propósito. Convierte, demuestra con la tabla de las próximas 100 ejecuciones y luego, cuando el trabajo sea idempotente, ejecuta la línea de cron y el temporizador en paralelo durante una semana y compara los resultados: los registros, las salidas, los efectos secundarios. Una semana cubre un ciclo semanal completo y normalmente un cambio de horario o un fin de mes si hay uno cerca, y cualquier disparo que predijo la tabla de demostración aparecerá en el journal junto a la ejecución de cron que duplica. Solo cuando ambos coincidan durante una semana completa borras la línea de cron, y conservas la copia comentada en la unidad como pista de la sección anterior.

Cuando el trabajo no es idempotente, porque envía correo, cobra a un cliente o muta una base de datos, no ejecutes ambos, porque la duplicación es el error que intentas evitar. Demuestra con más rigor en su lugar: ejecuta la tabla de 100 ejecuciones cruzando un cambio de horario y un fin de mes, revisa a mano las primeras filas que difieren y cambia en un solo paso, con la línea antigua comentada en la unidad. Después audita la unidad terminada como auditarías cualquier otra: puntúala con el auditor de unidades de systemd y lee el artículo complementario Cómo endurecer los servicios de systemd, porque un temporizador migrado hereda las mismas preguntas de sandbox que cualquier otra unidad. Mantén el temporizador, el servicio y la demostración en control de versiones: un horario que vive solo en una máquina está a una reconstrucción de ser olvidado.

Fuentes

Preguntas frecuentes

¿OnCalendar es solo cron con otra sintaxis?

No: la sintaxis se solapa, pero la semántica difiere en los puntos que importan. Cron aplica OR entre el día del mes y el día de la semana cuando ambos están restringidos; OnCalendar aplica AND. OnCalendar admite segundos, rangos de fechas como 01..07, rangos de días de semana, zonas horarias y sintaxis de último día del mes con "~", nada de lo cual puede expresar una línea de cron de cinco campos. También admite varias líneas OnCalendar en una unidad y temporizadores monótonos como OnBootSec=. La mayoría de los horarios simples se traducen sin problemas; los casos trampa son las combinaciones DOM+DOW, los segundos, @reboot y los rangos de fechas, y esos son justo los casos que el conversor marca en lugar de adivinar.

¿Qué ocurre con un disparo de temporizador dentro del hueco del cambio de primavera?

Las páginas del manual no lo dicen. crontab(5) es explícito para cron: un trabajo programado en la hora perdida nunca se ejecuta, y un trabajo programado en la hora repetida se ejecuta dos veces. systemd.time(7) y systemd.timer(5) no enuncian ninguna regla equivalente para OnCalendar, así que no des por supuesto que un temporizador se comporta como cron a las 02:30 del día del cambio de primavera. La comprobación honesta es la tabla de demostración: genera las próximas 100 ejecuciones cruzando el cambio de horario en el conversor y lee lo que ocurre realmente. Si el trabajo es sensible a la hora, la opción más segura es programarlo fuera de las 02:00–03:00 por completo.

¿Puedo ejecutar cron y el temporizador en paralelo durante la migración?

Sí, si el trabajo es idempotente, es decir, seguro ejecutarlo dos veces con el mismo resultado. Ejecuta ambos durante una semana, compara los registros y las salidas, y borra la línea de cron solo cuando ambos coincidan. Si el trabajo no es idempotente, porque envía correo, cobra un pago o muta estado, no ejecutes ambos, porque la ejecución duplicada es en sí misma el fallo. En ese caso, demuestra el horario con la tabla de 100 ejecuciones, cambia en un solo paso y mantén la línea antigua de cron comentada en la unidad para que la conversión siga siendo auditable.