Tutorial de Debian 13 / Programar tareas con temporizadores systemd y evitar ejecuciones simultáneas

En Debian 13, los temporizadores de systemd establecen la hora de ejecución, y el servicio vinculado realiza el trabajo real. Incluso si un temporizador está activo, la tarea puede fallar, por lo que se debe verificar no solo la siguiente programación, sino también el código de salida del servicio, los registros y los resultados generados.

Verifique los requisitos del laboratorio de copia de archivos

Esta vez, se copiará un único archivo de texto a un archivo de resultado desde la carpeta dedicada del usuario regular lfstudent. Si el contenido del original y del resultado es el mismo, no se sobrescribirá, y si otra ejecución está ocurriendo simultáneamente, será rechazada por un bloqueo. Este no es un programa de respaldo que preserva datos de múltiples puntos en el tiempo, sino que se dirige a archivos de prueba pequeños donde el original no cambia durante la operación.

Usamos flock, mktemp y cmp en systemd 257 de Debian 13. flock es un comando que obtiene un bloqueo exclusivo entre procesos basado en un archivo. Si ya existen nuevas unidades, carpetas o scripts, primero revise el contenido y no sobrescriba.

id lfstudent
command -v flock mktemp cmp
systemctl show lf-timer18.timer -p LoadState
ls -ld /home/lfstudent/lf-timer18
ls -l /usr/local/libexec/lf-timer18.sh /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer

Confirme que el temporizador muestra LoadState=not-found y que las rutas de práctica restantes no existan. Los errores de archivo no encontrado son un resultado esperado de la verificación previa. Si las herramientas no existen, consulte los paquetes con apt-cache show util-linux coreutils diffutils e instale mediante APT los que necesite. La diferencia entre estado de ejecución e inicio automático se explica en el laboratorio de servicios systemd y archivos drop-in.

Escriba un script de copia de archivos idempotente

Inicie sesión con lfstudent para crear un original dedicado. Si la carpeta ya existe, mkdir falla y el printf encadenado no se ejecuta. En ese caso, deténgase y examine el directorio existente antes de continuar.

mkdir /home/lfstudent/lf-timer18 &&
printf 'scheduled-copy-v1\n' > /home/lfstudent/lf-timer18/source.txt

Prepare la carpeta para el script con privilegios de administrador, abra sudo nano /usr/local/libexec/lf-timer18.sh y guarde el script completo siguiente. Si nano no está disponible, elija otro editor.

sudo install -d /usr/local/libexec
#!/bin/sh
set -eu
task_dir=/home/lfstudent/lf-timer18
exec 9>"$task_dir/.lock"
if ! flock -n 9; then
    printf 'Another copy is running\n' >&2
    exit 75
fi
test -r "$task_dir/source.txt"
if test -f "$task_dir/snapshot.txt" && cmp -s "$task_dir/source.txt" "$task_dir/snapshot.txt"; then
    printf 'Snapshot unchanged\n'
    exit 0
fi
task_tmp=$(mktemp "$task_dir/.snapshot.XXXXXX")
trap 'rm -f -- "$task_tmp"' EXIT HUP INT TERM
cat "$task_dir/source.txt" > "$task_tmp"
mv -- "$task_tmp" "$task_dir/snapshot.txt"
printf 'Snapshot updated\n'

Este es un script que debe guardarse en un archivo y no se ejecuta como un comando al pegarlo en el terminal para reemplazar toda la shell actual. Después de guardar, verifique el permiso de ejecución y la sintaxis.

sudo chmod 755 /usr/local/libexec/lf-timer18.sh
sh -n /usr/local/libexec/lf-timer18.sh
ls -l /usr/local/libexec/lf-timer18.sh

Los archivos ejecutables propiedad de los administradores no pueden ser modificados por usuarios regulares, y la carpeta de datos real es utilizada por lfstudent. mktemp crea un archivo temporal en la misma carpeta y lo renombra después de copiarlo, de modo que durante el reemplazo normal, un programa que abre el archivo de resultado no recibe por esa ruta una copia todavía a medio escribir. Este ejemplo no garantiza durabilidad después de una falla de disco ni una copia consistente de una base de datos que se esté modificando simultáneamente. El nuevo archivo de resultado hereda los permisos de acceso restringido de mktemp.

La idempotencia significa que repetir una operación con la misma entrada deja el mismo resultado. Aquí, copiar la misma entrada de nuevo no añade datos duplicados. Este script muestra Snapshot unchanged y sale si el contenido es el mismo. El bloqueo solo funciona entre ejecuciones cooperativas usando el mismo archivo. No evita que otros programas modifiquen el original. Puede consultar la adquisición de bloqueos sin espera y el comportamiento de salida en el manual de flock.

Cree el servicio oneshot y el temporizador de intervalo

Guarde la unidad de trabajo con sudo nano /etc/systemd/system/lf-timer18.service.

[Unit]
Description=Copy one lesson 18 test file

[Service]
Type=oneshot
User=lfstudent
ExecStart=/usr/local/libexec/lf-timer18.sh

Dado que esta es una tarea de corta duración que termina rápidamente, usamos oneshot. Debido a que necesita ser llamada repetidamente, no la mantenemos activa con RemainAfterExit=yes. Este servicio será activado por un temporizador, por lo que no hace falta añadir una sección [Install] al servicio para iniciarlo automáticamente.

Guarde lo siguiente en sudo nano /etc/systemd/system/lf-timer18.timer. Los intervalos de 5 segundos y 20 segundos son intervalos de práctica para observar los resultados rápidamente y no se recomiendan para ciclos operativos.

[Unit]
Description=Lesson 18 interval timer

[Timer]
OnActiveSec=5s
OnUnitInactiveSec=20s
AccuracySec=1s
Unit=lf-timer18.service

[Install]
WantedBy=timers.target

Después de activar el temporizador, se solicita la primera ejecución aproximadamente a los 5 segundos, y está configurado para ejecutarse nuevamente aproximadamente 20 segundos después de que la unidad de trabajo entre en un estado inactivo. Esto no garantiza una ejecución en tiempo real precisa y puede retrasarse dependiendo de la carga, la configuración de precisión, etc. Si el mismo servicio está ejecutándose, el temporizador no ejecutará una instancia de servicio separada simultáneamente. Considerando otros puntos de entrada donde el script puede ejecutarse directamente, también se coloca un bloqueo dentro del script. Las opciones de programación se basan en la documentación de systemd.timer.

sudo systemd-analyze verify /etc/systemd/system/lf-timer18.service /etc/systemd/system/lf-timer18.timer
sudo systemctl daemon-reload
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt
sudo systemctl enable --now lf-timer18.timer
systemctl list-timers lf-timer18.timer --no-pager

La ejecución manual debe informar Result=success y el estado de salida 0, y cmp debe tener éxito sin salida. Luego, encienda el temporizador. El estado inactivo de un servicio oneshot completado puede ser un resultado normal, por lo que lea tanto el Result como el código de salida juntos. El temporizador mostrará la próxima ejecución programada y la última vez que se ejecutó.

Después de la primera activación programada, verifique el temporizador, el resultado del trabajo y los datos copiados.

systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 20
cat /home/lfstudent/lf-timer18/snapshot.txt
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt

Verifique las marcas de tiempo del journal junto con Snapshot updated o Snapshot unchanged, y los resultados reales. La prueba del curso original confirmó la activación automática del servicio por el temporizador y una nueva ejecución sin cambios cuando el archivo de origen seguía siendo el mismo.

Compare el fallo del trabajo con un temporizador activo

Sin eliminar el original, cambie solo su nombre para crear un fallo de lectura. Primero, asegúrese de que source.saved no exista ya. Ejecute esto solo en un ejercicio dedicado sin otras tareas que utilicen la misma carpeta de datos.

test ! -e /home/lfstudent/lf-timer18/source.saved &&
mv /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/source.saved
sudo systemctl start lf-timer18.service
systemctl is-active lf-timer18.timer
systemctl show lf-timer18.service -p Result -p ExecMainCode -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-timer18.service -b --no-pager -n 12
systemctl list-timers lf-timer18.timer --no-pager

La solicitud de inicio falla: el servicio muestra Result=exit-code y ExecMainStatus=1. El temporizador puede permanecer activo, y también se mantiene la siguiente programación. Es decir, el hecho de que se mantenga la programación no significa que la copia del archivo haya sido exitosa. En el ejercicio, se puede confirmar que después del fallo, el archivo de resultado válido anterior permanece intacto. Si el original no se restaura antes de que el temporizador se ejecute nuevamente, el mismo fallo puede repetirse.

mv /home/lfstudent/lf-timer18/source.saved /home/lfstudent/lf-timer18/source.txt
sudo systemctl start lf-timer18.service
systemctl show lf-timer18.service -p Result -p ExecMainStatus
cmp /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt

Después de restaurar el original, verifique Result=success, estado de salida 0 y coincidencia de contenido mediante reejecución manual. Ejecutar simplemente reset-failed no restaura el archivo original. En las operaciones, se deben mantener registros y monitorear los resultados de las tareas, o configurar notificaciones de fallos por separado.

Pruebe un conflicto de bloqueo y repita tras liberarlo

Para evitar mezclarse con llamadas automáticas y comparaciones, primero detenga este temporizador de ejercicio. Deshabilitar también elimina el enlace de inicio de este temporizador.

sudo systemctl disable --now lf-timer18.timer

En el terminal A, conectado como lfstudent, mantenga el bloqueo temporalmente.

flock /home/lfstudent/lf-timer18/.lock sleep 20

Ejecute en el Terminal B con el mismo usuario antes de que pasen 20 segundos.

/usr/local/libexec/lf-timer18.sh
echo $?

Se esperan el mensaje Another copy is running y el código de salida 75 definido explícitamente por el script. Un conflicto en flock -n devuelve 1 de forma predeterminada. Si lo ejecuta nuevamente después de que finalice el comando en el Terminal A, tendrá éxito. No determine que está bloqueado solo porque el archivo de bloqueo permanezca. Lo que importa es si un proceso todavía mantiene el bloqueo sobre el archivo, y si elimina el archivo para resolver una colisión, se puede crear un objetivo de bloqueo separado, permitiendo la ejecución duplicada.

Elija un temporizador de calendario o cron

Si necesita tiempos basados en calendario, como las 02:00 diarias en la zona Asia/Seoul, en lugar de temporizadores de intervalo para práctica, considere OnCalendar. Primero, analice la expresión siguiente y compruebe la próxima ejecución. El ejemplo conserva la zona de la prueba original. Para ejecutar a las 02:00 de Madrid, sustituya Asia/Seoul por Europe/Madrid tanto en esta consulta como en OnCalendar. Para otra región, elija su identificador IANA y revise las fechas y los posibles cambios de horario. Mantener Asia/Seoul programa la hora coreana, independientemente de dónde esté el equipo.

systemd-analyze calendar '*-*-* 02:00:00 Asia/Seoul'

A continuación se muestra un ejemplo separado que se puede usar al reemplazar el archivo de temporizador existente. Reemplace los ajustes de intervalo; no mantenga OnActiveSec y OnUnitInactiveSec junto con este calendario. Si se utilizan múltiples condiciones de programación juntas, se puede activar por cualquiera de las condiciones. La ejecución automática y la comparación de fallos de la prueba original se realizaron utilizando el temporizador de intervalo corto mencionado anteriormente.

[Unit]
Description=Daily lesson 18 file copy

[Timer]
OnCalendar=*-*-* 02:00:00 Asia/Seoul
Persistent=true
Unit=lf-timer18.service

[Install]
WantedBy=timers.target

Si elige la variante de calendario, primero detenga este temporizador del laboratorio, sustituya su archivo completo y ejecute sudo systemd-analyze verify /etc/systemd/system/lf-timer18.timer. Si la validación tiene éxito, ejecute sudo systemctl daemon-reload, luego sudo systemctl enable --now lf-timer18.timer e inspeccione systemctl list-timers lf-timer18.timer --no-pager. Para volver a la prueba de intervalo corto, detenga el temporizador, restaure el archivo completo anterior, valide, vuelva a cargar las definiciones e inícielo de nuevo. El análisis del calendario se verificó en el laboratorio original; la recuperación de ejecuciones perdidas no se puso a prueba.

Persistent=true solo tiene efecto en temporizadores con OnCalendar. Al reactivarlos, solicita una ejecución de compensación si al menos un horario programado ocurrió durante la inactividad. No reproduce secuencialmente todas las ejecuciones por el número de veces que se perdieron, ni es una opción que tenga el mismo efecto que el temporizador de intervalo anterior. Las tareas basadas en calendario también necesitan verificar la sincronización con la hora del sistema y la zona horaria. Las reglas de expresión se pueden encontrar en la documentación de systemd.time.

Requisitos Criterio de elección
Gestión integral de cuentas de servicio, dependencias, códigos de salida y journal Combinar un servicio y un temporizador systemd
Mantener los comandos periódicos simples existentes específicos del usuario Verificar la configuración de cron existente, las variables de entorno y el manejo de salida
Compensar las tareas del calendario durante el tiempo que estuvo apagado Verificar la configuración Persistent del temporizador; no asumir que el cron ordinario proporciona un comportamiento de recuperación equivalente
Prevenir la ejecución duplicada del mismo script Para cualquier herramienta de programación, verificar también otros puntos de entrada y el diseño de bloqueo

Como se indica en el manual de crontab de Debian , cron requiere una consideración separada del usuario que ejecuta, el entorno y las condiciones de manejo del correo o la salida. No registre la misma tarea de manera redundante tanto en cron como en timer. Más importante que la elección de la herramienta es una configuración donde pueda observar los resultados y fallos reales de la ejecución.

Elimine solo las unidades y los archivos del laboratorio

Si activó la variante de calendario con Persistent=true, detenga el timer y ejecute sudo systemctl clean --what=state lf-timer18.timer antes de eliminar su archivo de unidad para eliminar su marca de tiempo de activación almacenada. La versión de intervalo corto no crea este estado de Persistent.

Si aplicó el ejemplo de calendario, ese temporizador también debe retirarse. Detenga primero las unidades, confirme que ninguna copia sigue ejecutándose y elimine solo los archivos creados para este ejercicio.

sudo systemctl disable --now lf-timer18.timer
sudo systemctl stop lf-timer18.service
sudo rm -- /etc/systemd/system/lf-timer18.timer /etc/systemd/system/lf-timer18.service /usr/local/libexec/lf-timer18.sh
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-timer18/source.txt /home/lfstudent/lf-timer18/snapshot.txt /home/lfstudent/lf-timer18/.lock
rmdir -- /home/lfstudent/lf-timer18
systemctl show lf-timer18.timer -p LoadState
systemctl show lf-timer18.service -p LoadState

Asegúrese de que ambas unidades muestren LoadState=not-found y que la carpeta haya sido eliminada. Si el nombre temporal original u otros archivos permanecen en la carpeta, revise el contenido antes de proceder y no use la eliminación recursiva para evitar esa verificación. Conserve los directorios compartidos como /usr/local/libexec, otros temporizadores y archivos del journal existentes.