Debian 13 : tutoriel / Planifier des tâches avec systemd et diagnostiquer leurs échecs

Dans Debian 13, les temporisateurs (timers) systemd définissent le moment d'exécution, et le service lié accomplit le travail réel. Même si un timer est actif, la tâche peut échouer, vous devriez donc vérifier non seulement la prochaine planification mais aussi le code de sortie du service, les journaux et les résultats générés.

Vérifiez les exigences du laboratoire de copie de fichiers

Cette fois, un seul fichier texte sera copié dans un fichier de résultat depuis le dossier dédié de l’utilisateur ordinaire lfstudent. Si le contenu original et le résultat sont identiques, il ne sera pas écrasé, et si une autre exécution a lieu simultanément, elle sera rejetée par un verrou. Ce n'est pas un programme de sauvegarde qui préserve les données à partir de plusieurs points dans le temps, mais plutôt destiné à de petits fichiers de test où l'original ne change pas pendant l'opération.

Nous utilisons flock, mktemp et cmp sur systemd 257 de Debian 13. flock est une commande qui obtient un verrou exclusif entre les processus basé sur un fichier. Si de nouvelles unités, dossiers ou scripts existent déjà, vérifiez d'abord le contenu et ne les écrasez pas.

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

Confirmez que le minuteur n'est pas trouvé et que les chemins de pratique restants n'existent pas. Les erreurs de fichier non trouvé sont un résultat attendu de la vérification préalable. Si les outils n'existent pas, vérifiez les paquets comme apt-cache show util-linux coreutils diffutils pour installer les outils nécessaires. L'état d'exécution et la configuration de démarrage utilisent la distinction couverte dans la création d’un service systemd et l’utilisation d’un complément drop-in.

Écrivez un script de copie de fichier idempotent

Connectez-vous avec lfstudent pour créer un original dédié. Si le même dossier existe, la commande ci-dessous ne l'écrasera pas.

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

Préparez un dossier pour enregistrer le script avec les privilèges administrateur et écrivez tout le contenu ci-dessous à partir de sudo nano /usr/local/libexec/lf-timer18.sh. Si nano n'est pas disponible, choisissez un éditeur que vous utilisez.

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'

Ceci est un script à enregistrer dans un fichier et n'est pas exécuté comme une commande en le collant dans le terminal pour remplacer l'ensemble du shell actuel. Après l'enregistrement, vérifiez la permission d'exécution et la syntaxe.

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

Les fichiers exécutables appartenant aux administrateurs ne peuvent pas être modifiés par les utilisateurs ordinaires, et le dossier de données réel est utilisé par lfstudent. mktemp crée un fichier temporaire dans le même dossier et le renomme après copie, de sorte que lors du remplacement normal, le lecteur ne lit pas un chemin de résultat partiellement écrit. Cet exemple ne garantit pas la durabilité après une panne de disque ni une copie cohérente d'une base de données modifiée simultanément. Le nouveau fichier de résultat hérite des permissions d'accès restreintes de mktemp.

L'idempotence signifie que répéter une opération avec la même entrée produit le même résultat. Ici, copier la même entrée à nouveau n'ajoute pas de données en double. Ce script affiche Snapshot unchanged et se termine si le contenu est identique. Le verrouillage ne fonctionne qu'entre des exécutions coopératives utilisant le même fichier. Il n'empêche pas d'autres programmes de modifier l'original. Vous pouvez vérifier les verrous non bloquants et le comportement de sortie dans le manuel flock.

Créer un service oneshot et un temporisateur à intervalle

Enregistrer l'unité de travail en tant que 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

Puisqu'il s'agit d'une tâche de courte durée qui se termine rapidement, nous utilisons oneshot. Comme elle doit être appelée à plusieurs reprises, nous ne la maintenons pas active avec RemainAfterExit=yes. Ce service sera déclenché par un minuteur, donc aucune connexion [Install] séparée n'est créée.

Enregistrez ce qui suit dans sudo nano /etc/systemd/system/lf-timer18.timer. Les intervalles de 5 secondes et 20 secondes sont des intervalles d'essai pour observer les résultats rapidement et ne sont pas recommandés pour les cycles opérationnels.

[Unit]
Description=Lesson 18 interval timer

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

[Install]
WantedBy=timers.target

Après l'activation du minuteur, la première exécution est demandée après environ 5 secondes, et il est configuré pour s'exécuter à nouveau environ 20 secondes après que l'unité de travail est passée à un état inactif. Cela ne garantit pas une exécution en temps réel précise et peut être retardé en fonction de la charge, des paramètres de précision, etc. Si le même service est en cours d'exécution, le minuteur n'exécutera pas simultanément une instance de service distincte. En tenant compte des autres points d'entrée où le script peut être exécuté directement, un verrou est également placé à l'intérieur du script. Les options de planification sont basées sur la documentation 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

L'exécution manuelle devrait indiquer Result=success et un code de sortie 0, et cmp doit réussir sans sortie. Ensuite, activez le minuteur. L'état inactif d'un service oneshot terminé peut être un résultat normal, donc lisez à la fois le Result et le code de sortie ensemble. Le minuteur affichera la prochaine exécution programmée et la dernière heure d'exécution.

Après la première activation programmée, vérifiez le minuteur, le résultat du travail et les données copiées.

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

Vérifiez les horodatages du journal avec Snapshot updated ou Snapshot unchanged, et les résultats réels. Dans cet exercice, nous avons confirmé que le minuteur active le service qui exécute le script de copie de fichiers, et lors d'une réexécution avec la même source, cela se termine sans modification.

Comparez l'échec du travail avec un minuteur actif

Sans supprimer l’original, changez uniquement son nom pour provoquer une erreur de lecture. Tout d’abord, assurez-vous que source.saved n’existe pas déjà. Exécutez cela uniquement dans un exercice dédié sans autres tâches utilisant le même dossier de données.

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 demande de démarrage échoue : Result indique exit-code et ExecMainStatus vaut 1. Le minuteur peut rester actif et la prochaine échéance reste affichée. C’est-à-dire que le fait que le calendrier soit maintenu ne signifie pas que la copie du fichier a réussi. Dans l’exercice, il peut être confirmé qu’après un échec, le fichier de résultat valide précédent reste intact. Si l’original n’est pas restauré avant que le minuteur ne redémarre, le même échec peut se reproduire.

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

Après avoir restauré l'original, vérifier que Result=success, le code de sortie est 0 et que le contenu correspond en réexécutant manuellement. Exécuter simplement reset-failed ne restaure pas le fichier original. Lors des opérations, les journaux doivent être conservés et les résultats des tâches surveillés, ou des notifications d'échec configurées séparément.

Tester la contention de verrou et la nouvelle tentative après libération

Pour éviter de mélanger avec les appels automatiques et la comparaison, arrêter d'abord ce minuteur d'exercice. La désactivation supprime également le lien de démarrage de ce minuteur.

sudo systemctl disable --now lf-timer18.timer

Dans le terminal A, connecté en tant que lfstudent, maintenir le verrou temporairement.

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

Exécuter sur le terminal B avec le même utilisateur avant que 20 secondes ne se soient écoulées.

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

Another copy is running et le code de sortie 75 défini par le script sont attendus. Le code 75 est choisi explicitement par ce script ; avec flock -n, un conflit de verrou renvoie par défaut 1. Si vous l'exécutez à nouveau après la fin de la commande sur le Terminal A, cela réussira. Ne déterminez pas qu'il est verrouillé simplement parce que le fichier de verrouillage reste. Le critère est de savoir si le processus en cours détient le fichier, et si vous supprimez le fichier pour résoudre une collision, une cible de verrouillage distincte peut être créée, permettant une exécution en double.

Choisir un temporisateur calendaire ou cron

Si vous avez besoin d'heures basées sur le calendrier, comme 2 h chaque jour dans le fuseau Asia/Seoul, plutôt que l’intervalle court de l’exercice, considérez OnCalendar. Analysez d’abord l’expression ci-dessous pour vérifier l’échéance. Pour une planification française, remplacez Asia/Seoul par Europe/Paris dans cette commande et dans OnCalendar : vérifiez les prochaines dates calculées, notamment autour des changements d’heure. Conserver Asia/Seoul programme l’heure coréenne, même depuis un ordinateur situé en France.

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

Ci-dessous se trouve un exemple séparé qui peut être utilisé lors du remplacement du fichier de minuterie existant. Remplacez les paramètres d'intervalle ; ne conservez pas OnActiveSec et OnUnitInactiveSec en même temps que ce calendrier. Si plusieurs conditions de planification sont utilisées ensemble, cela peut être déclenché par l'une quelconque des conditions. L'exécution automatique réelle et la comparaison des échecs dans cette leçon ont été effectuées en utilisant le minuteur à intervalle court mentionné précédemment.

[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 vous choisissez la variante calendrier, arrêtez d'abord ce minuteur de laboratoire, remplacez son fichier complet et exécutez sudo systemd-analyze verify /etc/systemd/system/lf-timer18.timer. Si la validation réussit, exécutez sudo systemctl daemon-reload, puis sudo systemctl enable --now lf-timer18.timer et inspectez systemctl list-timers lf-timer18.timer --no-pager. Pour revenir au test à intervalle court, arrêtez le minuteur, restaurez le fichier complet précédent, validez, rechargez et redémarrez-le. L'analyse du calendrier a été vérifiée dans le laboratoire original ; le rattrapage des exécutions manquées n'a pas été testé.

Persistent=true est utilisé pour appeler des tâches afin de compenser les exécutions manquées lorsque le minuteur du calendrier était inactif pendant ce temps. Il ne reproduit pas séquentiellement toutes les exécutions pour le nombre de fois manquées, ni n'est une option ayant le même effet que le minuteur d'intervalle précédent. Les tâches basées sur le calendrier doivent également vérifier la synchronisation avec l'heure du système et le fuseau horaire. Les règles d'expression peuvent être trouvées dans la documentation systemd.time.

Exigences Critères de jugement
Gestion complète des comptes de service, des dépendances, des codes de sortie et du journal Associer un service et un temporisateur systemd
Maintenir les commandes périodiques simples existantes spécifiques à l'utilisateur Vérifier la configuration cron existante, les variables d'environnement et la gestion des sorties
Compenser les tâches du calendrier pendant le temps où elles étaient désactivées Vérifier le paramètre Persistent du minuteur ; ne pas supposer que le cron ordinaire fournit un comportement de rattrapage équivalent
Empêcher l'exécution en double du même script Pour tout outil de planification, vérifier également les autres points d'entrée et la conception des verrous

Comme indiqué dans le manuel crontab de Debian , cron nécessite une considération séparée de l'utilisateur exécutant, de l'environnement et des conditions de gestion du courrier ou de la sortie. Ne pas enregistrer la même tâche de manière redondante à la fois dans cron et timer. Plus important que le choix de l'outil, il y a une configuration où vous pouvez observer les résultats réels de l'exécution et les échecs.

Supprimer uniquement les unités et les fichiers du laboratoire

Si vous avez activé la variante de calendrier persistant, arrêtez le timer et exécutez sudo systemctl clean --what=state lf-timer18.timer avant de supprimer son fichier d'unité pour supprimer son horodatage d'activation stocké. La version à court intervalle ne crée pas cet état persistant.

Si vous avez appliqué un exemple de calendrier, ce minuteur est également soumis au nettoyage. Arrêtez d’abord les unités, vérifiez qu’aucune copie n’est encore en cours, puis supprimez uniquement les fichiers créés pour cet exercice.

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

Assurez-vous que les deux unités sont introuvables et que le dossier a été supprimé. Si le nom temporaire d'origine ou d'autres fichiers restent dans le dossier, examinez le contenu avant de traiter, et n'utilisez pas la suppression récursive pour contourner cette vérification. Conservez les répertoires partagés tels que /usr/local/libexec, les autres minuteurs et les fichiers journaux existants.