Debian 13 : tutoriel / Gérer un conteneur Podman avec Quadlet et le gestionnaire systemd utilisateur
Pour faire fonctionner des conteneurs sans root en tant que services utilisateur sur Debian 13, vous créez le Quadlet original et gérez les services générés par le gestionnaire systemd de l’utilisateur. Le redémarrage après une terminaison anormale, l'arrêt explicite, la persistance après la déconnexion et le démarrage automatique au démarrage sont des conditions différentes, donc chacune doit être vérifiée séparément. Dans ce tutoriel, nous créons des conteneurs web et des volumes séparés, préservons la valeur originale de linger, puis vérifions la réponse HTTP.
Distinguer les fichiers source Quadlet des services générés
Quadlet est une fonctionnalité de Podman qui lit des fichiers avec des extensions telles que .container pour générer des services systemd. Les utilisateurs ordinaires placent généralement le fichier source dans ~/.config/containers/systemd et le gèrent avec systemctl --user. Si vous modifiez directement un fichier .service généré sous /run/user/UID/systemd/generator, il disparaîtra lors de la régénération, il faut donc corriger le fichier original.
Ce tutoriel a été exécuté dans un environnement Podman 5.4.2, cgroup v2, gestionnaire utilisateur systemd. Selon la documentation de Quadlet de Podman 5.4.2, nous utilisons les clés supportées Image, ContainerName, PublishPort, Volume et Pull. Pour éviter les problèmes où les services ne sont pas générés en utilisant directement les clés de la documentation plus récente, vérifiez d'abord la version installée et la sortie du générateur.
Le service généré n'est pas quelque chose géré via systemctl enable comme un fichier de service permanent classique. Si vous mettez WantedBy=default.target dans la section [Install] du fichier original, le générateur crée un lien vers la cible par défaut de l'utilisateur. N'essayez pas de changer de compte en ajoutant User= dans un fichier original sans root ; travaillez plutôt en tant qu'utilisateur normal réel.
Préparer la session utilisateur, l'image et le volume dédié
Utilisez l'environnement Podman de l'utilisateur normal vérifié dans la leçon précédente. Seules les installations de paquets sont faites avec sudo, et les commandes podman et systemctl --user suivantes sont exécutées en tant qu'utilisateur normal. Le port 8080 et le nom lf-web28 doivent être disponibles. Cet exemple utilise lf-web28-data, qui est différent du volume de la leçon précédente.
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
podman info --format json
systemctl --user is-system-running
loginctl show-user "$(id -un)" -p Linger
ss -ltn
Dans un nouveau terminal Bash, exécutez le bloc de préparation suivant. Linger s'applique à l'ensemble du gestionnaire d'utilisateurs pour le compte, donc considérez la portée de maintenance avant de l'utiliser sur un compte avec d'autres services utilisateur. Conservez un enregistrement séparé de la valeur originale afin de ne pas changer un compte qui était initialement yes en no lors du nettoyage.
set -euo pipefail
record="$HOME/lf-course28-linger-before.txt"
qdir="$HOME/.config/containers/systemd"
for p in "$record" "$qdir/lf-web28.container"; do
if test -e "$p"; then
echo "Path already exists: $p" >&2
exit 1
fi
done
if podman container exists lf-web28; then exit 1; fi
if podman volume exists lf-web28-data; then exit 1; fi
loginctl show-user "$(id -un)" -p Linger --value > "$record"
cat "$record"
podman pull docker.io/library/httpd:2.4.71-trixie
image=$(podman image inspect docker.io/library/httpd:2.4.71-trixie --format '{{index .RepoDigests 0}}')
case "$image" in
docker.io/library/httpd@sha256:*) ;;
*) echo "Check the image reference." >&2; exit 1 ;;
esac
podman image exists "$image"
podman volume create lf-web28-data
podman run --rm --network none -v lf-web28-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF QUADLET 28\n" > /data/index.html'
mkdir -p "$qdir"
Cet exercice récupère l'image à l'avance et utilise un digest. Pull=never dans le service empêche toute tentative de téléchargement au démarrage, donc si l'image n'est pas locale, le démarrage échouera. Ne supposez pas qu'il se rétablira automatiquement même si l'image est supprimée ; établissez des procédures pour la rétention et la mise à jour des images ensemble. La racine web de l'image httpd officielle peut être consultée dans guide de l'image httpd.
Écrire le Quadlet complet et inspecter la sortie du générateur
Enregistrez toute la configuration ci-dessous dans le même terminal. Comme le CONF du heredoc n'est pas entre guillemets, la variable $image définie précédemment sera remplacée par le digest réel. Ce fichier est la configuration pour cet utilisateur.
cat > "$qdir/lf-web28.container" <<CONF
[Unit]
Description=LF rootless web lab 28
[Container]
Image=$image
ContainerName=lf-web28
PublishPort=127.0.0.1:8080:80
Volume=lf-web28-data:/usr/local/apache2/htdocs:ro
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=180
[Install]
WantedBy=default.target
CONF
| Paramètres | Signification |
|---|---|
| PublishPort=127.0.0.1:8080:80 | Publier le port uniquement sur le loopback de la VM. |
| Volume=...:ro | Monter le volume de données web en lecture seule. |
| Restart=on-failure | Demander à systemd de redémarrer les services qui se sont arrêtés en raison d'une erreur. |
| RestartSec=2 | Attendre entre les redémarrages. Cela ne supprime pas la limite pour les échecs répétés. |
| TimeoutStartSec=180 | Définir une limite de temps pour attendre le démarrage du service. Cela ne vérifie pas le statut de disponibilité HTTP. |
| WantedBy=default.target | Le générateur se connecte pour démarrer à partir de la cible par défaut du gestionnaire d'utilisateurs. |
Avant de faire relire le fichier source par le gestionnaire utilisateur, limitez la recherche du générateur au répertoire de l’exercice, examinez sa sortie, puis exécutez daemon-reload. --dryrun est une fonction pour voir le contenu généré et ne démarre pas le conteneur.
QUADLET_UNIT_DIRS="$qdir" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user daemon-reload
systemctl --user cat lf-web28.service
systemctl --user show lf-web28.service -p FragmentPath -p SourcePath
Sur cette VM, le SourcePath était lf-web28.container dans le répertoire personnel, et le FragmentPath était /run/user/1000/systemd/generator/lf-web28.service. Le fichier généré incluait des commandes Podman run/cleanup et le digest de l'image. Si le service n'existe pas, vérifiez le chemin source, l'extension du fichier, les clés prises en charge et les erreurs du générateur, et ne créez pas et n'écrasez pas manuellement le fichier généré.
Activer linger, démarrer le service et vérifier HTTP
Activer linger démarre le gestionnaire d'utilisateur de ce compte au démarrage et le maintient disponible après la déconnexion. Comme l'explique le manuel loginctl de Debian , cela affecte le gestionnaire d'utilisateur, plutôt qu'un seul service. Dans le laboratoire enregistré, linger valait initialement no et a été passé à yes uniquement pour la vérification.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
systemctl --user start lf-web28.service
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman port lf-web28
La réponse attendue est LF QUADLET 28. L’état active signifie que le service généré est actif, et cela n'équivaut pas à ce que HTTP soit prêt. Lors de la vérification, une requête immédiatement après le démarrage a échoué avec Empty reply from server (réponse vide du serveur) mais a réussi une fois qu'il était prêt. N'attribuez pas tous les échecs à un délai de préparation ; essayez la requête à nouveau peu après, et si elle continue d'échouer, vérifiez les journaux suivants ainsi que l'état des ports et des volumes.
systemctl --user status lf-web28.service --no-pager
journalctl --user -u lf-web28.service -n 50 --no-pager
podman logs lf-web28
podman inspect lf-web28
Comparer les redémarrages dus à des échecs avec un arrêt explicite
La comparaison suivante se limite aux conteneurs de pratique dédiés qui fournissent uniquement des fichiers statiques. N'appliquez pas les tests de terminaison forcée tels quels aux services d'écriture réels tels que les bases de données. Tout d'abord, enregistrez l'ID du conteneur et le nombre de redémarrages, puis envoyez un signal KILL pour provoquer une terminaison par échec.
first=$(podman inspect lf-web28 --format '{{.Id}}')
systemctl --user show lf-web28.service -p NRestarts
podman kill --signal KILL lf-web28
sleep 3
systemctl --user is-active lf-web28.service
systemctl --user show lf-web28.service -p NRestarts
podman inspect lf-web28 --format '{{.Id}}'
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Lors de la vérification, NRestarts a augmenté, l'ID du conteneur a changé et les réponses HTTP ont de nouveau réussi. Les 3 secondes sont un exemple pour démarrer la vérification et ne garantissent pas le temps de récupération dans tous les environnements. Si des échecs répétés atteignent la limite, corrigez la cause trouvée dans le journal, puis utilisez reset-failed et redémarrez uniquement le service affecté. Les comptes de redémarrage peuvent être réinitialisés par les redémarrages d'administrateur et ne sont pas utilisés tels quels pour les statistiques d'échec à long terme.
Demandez maintenant explicitement un arrêt dans systemd. Avoir Restart=on-failure ne signifie pas que le service redémarrera automatiquement après une demande d'arrêt de l'administrateur. Les conditions de la politique suivent explication du redémarrage du service systemd.
systemctl --user stop lf-web28.service
sleep 3
if systemctl --user is-active --quiet lf-web28.service; then
echo "The explicitly stopped service is still active." >&2
exit 1
fi
systemctl --user show lf-web28.service -p ActiveState
podman ps -a --filter name=lf-web28
systemctl --user start lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Après l'arrêt, le résultat était inactif et le conteneur dédié a également été supprimé. L'exemple s'arrête avec une erreur s'il reste actif, et s'il s'arrête normalement, il vérifie ActiveState=inactive avant de redémarrer. Si une réponse n'est pas prête immédiatement après le démarrage, vérifiez le statut et les journaux comme décrit dans la section précédente et réessayez la demande. Les volumes restent indépendamment de la suppression du conteneur.
Vérifiez le démarrage avant la connexion et la persistance après la déconnexion
Après le redémarrage, connectez-vous en SSH avec le même utilisateur, et le fait que le service soit actif seul ne prouve pas un démarrage automatique avant la connexion. Cela est dû au fait que les services gérés par les utilisateurs pourraient démarrer pendant le processus de connexion. Dans ce tutoriel, une sonde indépendante effectuant des requêtes HTTP GET sous root, qui ne dépend pas des services utilisateur, a été programmée pour enregistrer les réponses et les listes de sessions à des moments où aucune session de connexion n’existe.
Pour vérifier de la même manière, après avoir confirmé que tous les chemins dédiés ci-dessous n’existent pas, une sonde de gestion root peut être préparée. Elle ne modifie pas les minuteries ou journaux existants sur d'autres serveurs. Même si le code s'exécute en tant que root, il effectue des requêtes HTTP GET et des requêtes de session et écrit son propre journal de preuves réservé au root ; il n’ajoute pas de dépendances telles que user@1000.service.
for p in /var/backups/lf-debian13-28 /usr/local/sbin/lf-boot28-probe /etc/systemd/system/lf-boot28-probe.service /etc/systemd/system/lf-boot28-probe.timer; do
if test -e "$p"; then echo "Already exists: $p" >&2; exit 1; fi
done
sudo install -d -m 700 /var/backups/lf-debian13-28
sudo tee /usr/local/sbin/lf-boot28-probe > /dev/null <<'PROBE'
#!/bin/bash
set -euo pipefail
label=${1:-boot}
case "$label" in boot|logout) ;; *) exit 1;; esac
dest="/var/backups/lf-debian13-28/$label-$(cat /proc/sys/kernel/random/boot_id).txt"
{
date -u --iso-8601=seconds
cat /proc/uptime
loginctl list-sessions --no-legend
for i in $(seq 1 15); do
if curl --noproxy '*' --max-time 2 -fsS http://127.0.0.1:8080/ | grep -Fx 'LF QUADLET 28'; then echo HTTP_PROBE_PASSED; exit 0; fi
sleep 1
done
exit 1
} > "$dest" 2>&1
PROBE
sudo chmod 700 /usr/local/sbin/lf-boot28-probe
sudo tee /etc/systemd/system/lf-boot28-probe.service > /dev/null <<'UNIT'
[Unit]
Description=Read-only HTTP evidence before user login for lab 28
After=network-online.target
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-boot28-probe boot
UNIT
sudo tee /etc/systemd/system/lf-boot28-probe.timer > /dev/null <<'TIMER'
[Unit]
Description=One boot HTTP evidence for lab 28
[Timer]
OnBootSec=35s
AccuracySec=1s
Unit=lf-boot28-probe.service
[Install]
WantedBy=timers.target
TIMER
sudo systemctl daemon-reload
sudo systemctl enable lf-boot28-probe.timer
Tout d'abord, testez s'il est maintenu après la déconnexion. Si la planification ci-dessous réussit, déconnectez toutes les sessions interactives de l'utilisateur cible, attendez au moins 70 secondes, puis reconnectez-vous pour lire les données enregistrées. Garder la session ouverte immédiatement après la planification n'est pas une vérification de la déconnexion. Si une unité transitoire du même nom reste, vérifiez l'état existant et évitez une exécution en double.
sudo systemd-run --unit=lf-logout28-probe --on-active=15s --timer-property=AccuracySec=1s /usr/local/sbin/lf-boot28-probe logout
La sonde enregistre la liste des sessions avant sa boucle de nouvelle tentative, donc cette liste seule est insuffisante si vous vous connectez pendant qu'elle est encore en train de réessayer. Après la reconnexion, inspectez sudo journalctl -b -u lf-logout28-probe.service --no-pager et comparez l'heure de fin réussie du travail avec l'heure de connexion affichée par loginctl session-status. Utilisez la requête de journal équivalente pour lf-boot28-probe.service après le redémarrage. N'acceptez les preuves que si la sonde a réussi et s'est terminée avant que l'utilisateur cible ne se soit connecté. Tenez compte des décalages de fuseau horaire lors de la comparaison de l'horodatage du fichier UTC avec les heures du journal/de la session. Les attentes de 70/90 secondes permettent les nouvelles tentatives limitées de la sonde dans des conditions de charge normales ; le temps écoulé seul ne constitue pas une preuve.
Après s'être reconnecté, vérifiez l'heure de la sonde, la liste des sessions et HTTP_PROBE_PASSED en utilisant la commande suivante. Distinguez entre la session du gestionnaire utilisateur de la classe manager et la session de connexion réelle de l'utilisateur de la classe user. Si le compte cible conservait une autre session de connexion au moment de la sonde, ce résultat ne prouve pas le maintien du service après déconnexion de toutes ses sessions.
sudo cat "/var/backups/lf-debian13-28/logout-$(cat /proc/sys/kernel/random/boot_id).txt"
sudo systemctl show lf-logout28-probe.service -p Result -p ExecMainStatus
Voici les étapes pour redémarrer normalement la VM après avoir vérifié l'accès à la console et l'impact sur les autres services en cours. Notez l'ID de démarrage avant de commencer, et après le redémarrage, laissez cet utilisateur déconnecté pendant au moins 90 secondes. Accéder avant que le minuteur ne se termine peut fausser les résultats, donc comparez l'heure enregistrée avec l'heure de connexion réelle également.
cat /proc/sys/kernel/random/boot_id
sudo systemctl reboot
Après vous être reconnecté, vérifiez si le nouvel ID de démarrage est différent du précédent, et lisez les enregistrements pour ce démarrage. S'il n'y a pas de journal ou si cela a échoué, cela n'est pas considéré comme un démarrage automatique réussi.
cat /proc/sys/kernel/random/boot_id
sudo cat "/var/backups/lf-debian13-28/boot-$(cat /proc/sys/kernel/random/boot_id).txt"
systemctl --user is-active lf-web28.service
curl --noproxy '*' -fsS http://127.0.0.1:8080/
Sur la VM de vérification, HTTP a réussi environ 46 secondes après le nouveau démarrage lorsque seule la session du gestionnaire existait et que l’état était lingering. Un test de déconnexion séparé a également réussi lorsqu'il n'y avait pas de session utilisateur réelle. La sonde initiale programmée avec la précision de minuterie par défaut n'a pas été utilisée comme preuve car elle se superposait à la reconnexion de vérification, et elle a été recontrôlée en spécifiant AccuracySec=1s. Le critère est de savoir si les résultats restaient avant la connexion plutôt que l'heure exacte d'exécution.
Retirer le fichier source et le volume, puis rétablir linger
L'arrêt interrompra l'exécution en cours, mais si l'original avec [Install] reste, il peut revenir au prochain démarrage du gestionnaire d'utilisateurs. Pour supprimer la configuration de pratique, supprimez l'original correspondant et exécutez daemon-reload pour nettoyer les liens générés. Le premier bloc ci-dessous doit être exécuté en tant qu'utilisateur régulier.
systemctl --user stop lf-web28.service
rm -- "$HOME/.config/containers/systemd/lf-web28.container"
systemctl --user daemon-reload
podman ps -a --filter name=lf-web28
podman volume rm lf-web28-data
Supprimer des volumes signifie supprimer des données, donc enregistrez d'abord tout contenu nécessaire. Ensuite, supprimez uniquement les minuteries et scripts du système de pratique. Les enregistrements de preuves peuvent être laissés dans un chemin de sauvegarde accessible uniquement par root.
sudo systemctl disable --now lf-boot28-probe.timer
sudo rm -- /etc/systemd/system/lf-boot28-probe.timer /etc/systemd/system/lf-boot28-probe.service /usr/local/sbin/lf-boot28-probe
sudo systemctl daemon-reload
original_linger=$(cat "$HOME/lf-course28-linger-before.txt")
case "$original_linger" in
no) sudo loginctl disable-linger "$(id -un)" ;;
yes) echo "Preserving the original enabled linger state." ;;
*) echo "Cannot determine the original linger value." >&2; exit 1 ;;
esac
loginctl show-user "$(id -un)" -p Linger
ss -ltn
Lors du nettoyage réel, le fichier source Quadlet, les services générés, les conteneurs, les volumes et les sondes propres à l’exercice ont été supprimés, le port d’écoute 8080 a été fermé, et le paramètre linger est revenu à sa valeur initiale no. Les images existantes et les autres services ont été préservés. Lors de la décision de continuer à exécuter les services utilisateurs réguliers, gérez ensemble la durée de vie des comptes, la rétention des données, ainsi que les procédures de mise à jour et de restauration.




