Debian 13 : tutoriel / Gérer les services systemd et appliquer un fichier drop-in
Dans Debian 13, active indique l'état d'activation actuel d'un service systemd, et enabled montre si ses liens de démarrage automatique sont activés. Si vous avez modifié le fichier d’unité ou son complément drop-in, utilisez daemon-reload pour que le gestionnaire systemd relise les définitions d'unités, et toute commande d'exécution modifiée doit être suivie d'un redémarrage du service et d'une vérification de la réponse réelle.
Distinguer l'état d'exécution de la configuration de démarrage
systemd gère des tâches comme les services, les temporisateurs et les points de montage en tant qu'unités. Ce tutoriel crée un service HTTP Python en boucle locale uniquement dans un environnement Debian 13 systemd 257, affichant son état et comparant les processus, les ports et les réponses. Il s'agit d'un exercice pour manipuler les services système généraux et n'implique pas de redémarrer tous les services existants de la même manière.
| Commandes | Cible à modifier | Résultat de cet exercice |
|---|---|---|
| start / stop | Service en cours d'exécution | Démarrer ou arrêter le service sans modifier ses liens de démarrage |
| enable / disable | Liens de démarrage de l'unité | Ajouter ou supprimer des liens de démarrage sans arrêter un processus en cours d'exécution |
| enable --now | Configuration du démarrage et état d'exécution | Activer les liens de démarrage et démarrer également le service maintenant |
| daemon-reload | Paramètres de l'unité lus par systemd | Relire les définitions d'unité sans remplacer le processus HTTP |
| restart | Processus du service | Appliquer une nouvelle commande d'exécution en arrêtant et en démarrant |
Même si enabled, le service peut échouer, et même si disabled, il peut être démarré manuellement ou exécuté à la demande d'une autre unité. Dans cet exemple, WantedBy=multi-user.target, placé dans la section [Install], désigne la cible pour laquelle les liens de démarrage sont créés. Il existe des services qui sont des unités statiques sans connexions d'installation ou qui démarrent via des sockets, donc ne déterminez pas le comportement au démarrage de tous les services uniquement en fonction de leur état activé. La signification détaillée des commandes peut être trouvée dans le manuel systemctl de Debian 13.
Vérifier l'état initial du laboratoire dédié
Utilisez le compte lfstudent capable de sudo, Python 3 et curl. S'il s'agit d'un compte différent, ajustez le User du service ci-dessous et le chemin du document pour correspondre au compte réel. Le serveur HTTP Python est à des fins d'entraînement et n'a pas besoin d'être exposé à l'hôte ou au LAN, donc il n'écoute que sur 127.0.0.1. Aucun transfert NAT ou modification du pare-feu n'est nécessaire.
id lfstudent
python3 --version
curl --version
systemctl --version
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
ls -ld /home/lfstudent/lf-http17 /etc/systemd/system/lf-http17.service.d
Le service est LoadState=not-found, aucun port n'a de ligne d'écoute, et le dossier n'existe pas comme condition de départ. La dernière commande ls doit signaler que les chemins n’existent pas : elle sert à vérifier qu’ils ne sont pas déjà utilisés. Si une ressource de laboratoire existe déjà, arrêtez-vous ici et identifiez son propriétaire. Ne l'écrasez pas et n'arrêtez pas un autre service. Si Python ou curl n'est pas installé, consultez la liste des modifications dans sudo apt install --no-install-recommends python3 curl pour les installer.
Créez un fichier dédié sur le terminal connecté en tant que lfstudent.
mkdir /home/lfstudent/lf-http17 &&
printf 'systemd-service-lab\n' > /home/lfstudent/lf-http17/probe.txt
Si la création du répertoire échoue, la commande printf enchaînée est ignorée. Arrêtez le laboratoire à ce moment-là plutôt que de continuer avec le fichier de service. La racine du document de pratique est restreinte séparément, et l'ensemble du répertoire personnel n'est pas fourni. Le service système est généralement géré par l'administrateur système, mais le processus HTTP lui-même est exécuté avec des permissions utilisateur ordinaires comme indiqué ci-dessous dans User=lfstudent.
Écrivez et validez l'unité de service complète
Ouvrez un nouveau fichier avec sudo nano /etc/systemd/system/lf-http17.service et enregistrez l'intégralité du contenu ci-dessous. Vous pouvez utiliser un autre éditeur, mais conservez le nom de fichier, le chemin et la structure des lignes. Ne remplacez pas un fichier existant par un nouvel exemple.
[Unit]
Description=Local HTTP service for lesson 17
[Service]
Type=exec
User=lfstudent
ExecStart=/usr/bin/python3 -m http.server 8080 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Restart=on-failure
RestartSec=2s
[Install]
WantedBy=multi-user.target
Type=exec aide à vérifier les erreurs lors de la phase de démarrage de l’exécutable. Cependant, le démarrage réussi de l’exécutable ne garantit pas que le socket d’écoute HTTP est prêt. Restart=on-failure est un paramètre permettant de redémarrer en cas d’arrêt anormal, et ce n’est pas une option pour relancer un service que l’administrateur a arrêté normalement.
Ne pas ajouter & pour une exécution en arrière-plan dans ExecStart. systemd gère directement le processus en le lançant au premier plan. Contrairement à une ligne de commande shell normale, les tubes (pipes) et les redirections ne sont pas automatiquement traités comme une syntaxe de shell. Consultez l’option pertinente dans la documentation systemd.service pour les méthodes d’exécution.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
systemctl cat lf-http17.service
Vérifiez la cause s'il y a des erreurs ou des avertissements lors de l'inspection. Même après lecture sans erreurs, il n'a pas encore démarré, les résultats attendus sont donc disabled et inactive. Ces deux requêtes renvoient des codes de sortie non nuls selon l'état, donc ne considérez pas simplement toutes les sorties anormales comme des échecs d'installation dans l'automatisation.
Observer séparément active et enabled
Tout d'abord, démarrez le service manuellement et vérifiez la réponse réelle du fichier.
sudo systemctl start lf-http17.service
systemctl is-active lf-http17.service
systemctl is-enabled lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo ss -lntp 'sport = :8080'
Attendez-vous respectivement à active et disabled pour les requêtes d’état, et systemd-service-lab à partir de la requête HTTP. Les tentatives limitées dans curl prennent en compte la courte différence pour que le port soit prêt immédiatement après le démarrage du processus. Si cela continue d'échouer, ne vous fiez pas uniquement au statut et vérifiez la cause avec sudo journalctl -u lf-http17.service -b --no-pager -n 30.
Activez le lien de démarrage, puis arrêtez le processus en cours.
sudo systemctl enable lf-http17.service
sudo systemctl stop lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
Les résultats attendus sont enabled et inactive. stop ne supprime pas les liens de démarrage automatique. Redémarrez le service, puis désactivez son lien de démarrage.
sudo systemctl start lf-http17.service
sudo systemctl disable lf-http17.service
systemctl is-enabled lf-http17.service
systemctl is-active lf-http17.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
Les résultats attendus sont disabled, active et une réponse HTTP contenant le même fichier. Dans cet exemple, la désactivation n'a pas arrêté le processus HTTP en cours. Si un arrêt immédiat est souhaité, utilisez disable --now. Dans cette comparaison, laissez-le actif et désactivé pour le changement de port ultérieur.
Changez le port avec un Drop-in
Un drop-in est une configuration supplémentaire ajoutée au dossier unit-name.d/ à côté du fichier d'unité original. Au lieu de modifier directement le fichier /usr/lib/systemd/system/ fourni par le paquet, les administrateurs gèrent généralement les modifications sous forme de drop-in de /etc/systemd/system/. Cet exemple applique la même méthode à une unité créée manuellement pour distinguer entre les fichiers originaux et supplémentaires.
systemctl show lf-http17.service -p MainPID -p ExecStart -p FragmentPath -p DropInPaths
sudo install -d /etc/systemd/system/lf-http17.service.d
MainPID désigne l’identifiant du processus principal du service (PID). Notez sa valeur actuelle pour la comparer ensuite. Créez le drop-in avec sudo nano /etc/systemd/system/lf-http17.service.d/20-port.conf.
[Service]
ExecStart=
ExecStart=/usr/bin/python3 -m http.server 8082 --bind 127.0.0.1 --directory /home/lfstudent/lf-http17
Un ExecStart= vide sert à réinitialiser la commande d'exécution précédemment définie et à la remplacer sur la ligne suivante. Si une deuxième commande d'exécution est ajoutée sans réinitialisation, le remplacement prévu pour ce type de service ne se produira pas. Les drop-ins fusionnent ou remplacent différemment selon l'option, donc tous les paramètres ne sont pas traités de la même manière. Le chemin de recherche de configuration et la description du drop-in de systemd.unit sont la référence.
sudo systemd-analyze verify /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
systemctl cat lf-http17.service
systemctl show lf-http17.service -p MainPID -p ExecStart -p DropInPaths
curl --noproxy '*' --max-time 5 -fsS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8082/probe.txt
Bien que le gestionnaire affiche désormais 8082 dans ExecStart, le MainPID du processus en cours d'exécution est la valeur précédente, et les réponses 8080 continuent. Les requêtes vers 8082 devraient échouer car rien n'écoute encore là-bas. Cette comparaison montre que daemon-reload relit la définition de l’unité sans redémarrer le processus qui l’utilise.
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p MainPID -p ActiveState -p SubState -p UnitFileState
sudo ss -lntp 'sport = :8082'
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8082/probe.txt
curl --noproxy '*' --max-time 3 -fsS http://127.0.0.1:8080/probe.txt
Vérifiez le PID du processus redémarré et vérifiez le socket d’écoute sur le port 8082 ainsi que le fichier de réponse, et comparez si le socket d’écoute précédent sur le port 8080 a disparu. Le numéro de PID varie selon l'environnement, et il est plus important de vérifier l’état, le socket d’écoute et la réponse ensemble que le numéro lui-même. La commande reload est également une action séparée. Cette unité n'a pas spécifié ExecReload, etc., donc elle n'utilise pas de rechargement non pris en charge comme moyen d'appliquer les paramètres.
Retirer uniquement le drop-in du laboratoire et rétablir le port 8080
Conserver le fichier de service original et supprimer uniquement le 20-port.conf créé cette fois. N'utilisez pas de réversion complète dans cette opération, ce qui pourrait effacer d'autres paramètres complémentaires.
sudo rm -- /etc/systemd/system/lf-http17.service.d/20-port.conf
sudo rmdir -- /etc/systemd/system/lf-http17.service.d
sudo systemctl daemon-reload
sudo systemctl restart lf-http17.service
systemctl show lf-http17.service -p ExecStart -p DropInPaths
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/probe.txt
sudo journalctl -u lf-http17.service -b --no-pager -n 20
La restauration est confirmée lorsque DropInPaths est vide, ExecStart spécifie à nouveau le port 8080, et la requête HTTP renvoie le fichier original. Si rmdir échoue parce qu'il n'est pas vide, vérifiez d'abord s'il y a d'autres fichiers et ne supprimez pas tout le dossier. Le journal conserve des traces du démarrage, de l'arrêt et des requêtes, ce qui vous permet de vérifier les transitions d'état.
Diagnostiquer les erreurs et supprimer le service dédié
Les fautes de frappe dans le chemin du fichier ou les problèmes d'autorisation d'accès peuvent se manifester par des échecs de requête HTTP ou des échecs au démarrage du service. Les conflits de ports peuvent être vérifiés avec ss pour voir si un autre serveur écoute. Lisez les résultats de systemctl status lf-http17.service --no-pager et les erreurs spécifiques dans le journal et corrigez-les. Exécuter uniquement reset-failed pour effacer les enregistrements de défaillance ne résout pas la cause sous-jacente.
Après avoir terminé l'exercice, arrêtez uniquement le service dédié, désactivez le démarrage automatique, puis supprimez les fichiers créés.
sudo systemctl disable --now lf-http17.service
sudo rm -- /etc/systemd/system/lf-http17.service
sudo systemctl daemon-reload
rm -- /home/lfstudent/lf-http17/probe.txt
rmdir -- /home/lfstudent/lf-http17
systemctl show lf-http17.service -p LoadState
sudo ss -lntp 'sport = :8080'
sudo ss -lntp 'sport = :8082'
Vérifiez que l’unité affiche LoadState=not-found et qu'aucun des ports de laboratoire n'a de ligne d'écoute. Si le service reste dans un état échoué, confirmez d'abord la suppression des fichiers et l'arrêt du processus, puis nettoyez uniquement les enregistrements de défaillance de cette unité avec sudo systemctl reset-failed lf-http17.service. Conservez les autres journaux de service et du système.




