Rocky Linux 10 : tutoriel / Gérer les conteneurs Quadlet et leur démarrage automatique sans root

Pour exploiter des conteneurs Podman en tant que service sur Rocky Linux 10, vous pouvez déclarer les conditions d'exécution dans un fichier Quadlet et laisser systemd gérer le démarrage, l'arrêt et le redémarrage. Pour le démarrage automatique des conteneurs d'utilisateurs réguliers au démarrage, vous devez vérifier la cible de démarrage du Quadlet et le paramètre de persistance qui maintient le gestionnaire d'utilisateur même sans connexion.

Relation entre Quadlet et les services utilisateur

Quadlet est une fonctionnalité de Podman qui décrit les conditions des conteneurs telles que les images, les ports et les volumes dans un fichier. Le générateur de systemd lit ce fichier pour créer un fichier de service ordinaire, qui est ensuite géré par systemctl. Au-delà de l'enregistrement de longues commandes podman run, il peut gérer à la fois la politique de redémarrage du service et la cible de démarrage.

Le laboratoire source utilisait un utilisateur régulier lfstudent sur Rocky Linux 10.2 avec Podman 5.8.2, systemd 257, la gestion des ressources cgroups v2 et SELinux en mode enforcing. Réutilisez l'image officielle Nginx vérifiée dans la leçon Podman sans root et le contenu local, en publiant uniquement sur 127.0.0.1:18028. Ce Quadlet s'exécute en tant que service utilisateur ; distinguez ses commandes des commandes sudo systemctl qui gèrent les services système.

podman version
podman info --format '{{.Host.Security.Rootless}}'
podman info --format '{{.Host.CgroupsVersion}}'
systemctl --user list-unit-files
podman ps -a
ss -lnt 'sport = :18028'
loginctl show-user "$(id -un)" -p Linger

La valeur rootless devrait être true, et les cgroups devraient être v2. S'il existe des services, conteneurs ou matériaux portant le même nom, ne les écrasez pas avec de nouveaux paramètres mais vérifiez-les d'abord. La configuration linger existante de cette VM était non, et pour l'exercice, elle a été changée en oui uniquement pour cet utilisateur, et rétablie à la fin.

Confirmez les options prises en charge selon la version installée. Documentation de Podman 5.8 série Quadlet explique le chemin de recherche utilisateur, la méthode de création et la correspondance de chaque paramètre. Ne supposez pas que les nouvelles options dans la documentation la plus récente sont prises en charge dans les paquets des distributions précédentes.

Après avoir vérifié les services utilisateur gérés par ce compte, définissez linger uniquement pour l'utilisateur concerné. Ce n'est pas une option pour un seul conteneur mais affecte la durée de vie du gestionnaire d'utilisateur pour ce compte. Les comptes qui étaient précédemment configurés sur oui ne sont pas arbitrairement changés en non à la fin de la pratique.

sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

Le manuel loginctl explique que linger est une fonctionnalité qui démarre le gestionnaire d'utilisateur au démarrage et le maintient actif même après la déconnexion.

Chemin du document et préparation du fichier Quadlet complet

Ce qui suit est exécuté dans un shell utilisateur normal. Le répertoire de données lf-course28 est nouvellement créé, en réutilisant les références d'images enregistrées dans la Leçon 27. Si la Leçon 27 n'a pas été effectuée, vous devez télécharger l'image officielle et vérifier la source et le digest pour préparer d'abord le même fichier de référence.

LAB28="$HOME/lf-course28"
test ! -e "$LAB28" || { printf 'Inspect the existing lab directory and stop.\n' >&2; exit 1; }
mkdir -m 0755 "$LAB28"
mkdir -m 0755 "$LAB28/site"
printf 'LF28 Quadlet service works\n' > "$LAB28/site/index.html"
chmod 0644 "$LAB28/site/index.html"
mkdir -p "$HOME/.config/containers/systemd"
cat "$HOME/lf-course27/image.ref"

Enregistrez le contenu complet suivant dans ~/.config/containers/systemd/lf-course28.container. Le chemin d'accueil ici est le chemin réel de l'utilisateur de la pratique. Si vous exécutez avec un autre compte, modifiez le chemin source du Volume pour correspondre à ce compte et spécifiez la référence de l'image avec la valeur que vous avez confirmée.

test ! -e "$HOME/.config/containers/systemd/lf-course28.container" || { printf 'Inspect the existing Quadlet file and stop.\n' >&2; exit 1; }
cat > "$HOME/.config/containers/systemd/lf-course28.container" <<'EOF'
[Unit]
Description=Course28 rootless web service
[Container]
Image=docker.io/library/nginx@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311
ContainerName=lf-course28-web
Label=lf.course=28
PublishPort=127.0.0.1:18028:80
Volume=/home/lfstudent/lf-course28/site:/usr/share/nginx/html:ro,Z
Pull=never
[Service]
Restart=on-failure
RestartSec=2
TimeoutStartSec=90
[Install]
WantedBy=default.target
EOF
Section · Paramètres Rôle dans ce service
[Container] Voici les exigences d'exécution de Podman telles que l'image, le nom, le port et le montage.
Pull=never Il utilise une image locale déjà enregistrée et vérifiée. Si elle n'est pas dans le cache, le démarrage échouera, donc préparez-la à l'avance.
Volume=…:ro,Z Fournissez de nouveaux documents dédiés en mode lecture seule et appliquez le contexte SELinux approprié pour le conteneur.
Restart=on-failure Redémarrez le service lorsqu'il se termine de manière anormale. Cela se distingue d'un arrêt explicite.
WantedBy=default.target Liez le service à la cible de démarrage par défaut du gestionnaire d'utilisateur.

Étant donné qu'il ne s'agit pas d'une configuration qui suit automatiquement les balises temporaires de l'image, la mise à jour implique de revoir le nouveau digest, de modifier le fichier, puis de le vérifier à nouveau. Seuls de nouveaux chemins dédiés sont utilisés pour les montages, et il ne faut pas monter ou relabeler l'intégralité du répertoire personnel.

Création de service, exécution et vérification HTTP réelle.

systemctl --user daemon-reload
systemctl --user cat lf-course28.service
systemctl --user start lf-course28.service
systemctl --user show lf-course28.service -p ActiveState -p SubState -p FragmentPath -p UnitFileState -p NRestarts
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
journalctl --user -u lf-course28.service -b -n 30 --no-pager

Le service effectivement créé se trouvait dans /run/user/1000/systemd/generator/lf-course28.service, et son statut était generated. Le fichier créé contenait des commandes d'exécution de conteneur et des commandes d'arrêt/nettoyage. Ne modifiez pas directement ce fichier ; modifiez le fichier .container original et recréez-le en exécutant daemon-reload.

Ce service était actif/en cours d'exécution et a renvoyé LF28 Quadlet service works. Le type par défaut du service créé est notify, et le programme de surveillance des conteneurs conmon signale son démarrage, mais cela seul n'est pas considéré comme suffisant pour déterminer que l'application web répond correctement. La réponse HTTP réelle et le contenu attendu sont vérifiés séparément. Une réinitialisation de connexion a été observée une fois immédiatement après le démarrage, donc des tentatives limitées ont été utilisées.

La méthode consistant à appliquer systemctl --user enable lf-course28.service au service créé comme un fichier normal n'est pas utilisée. Le générateur Quadlet gère les paramètres [Install] à partir du fichier original. Les conditions dans lesquelles le gestionnaire d'utilisateurs lui-même démarre au démarrage doivent être vérifiées séparément.

Comparer l'arrêt anormal avec un arrêt explicite.

Le test cible uniquement le conteneur créé dans ce tutoriel. L'ID du conteneur et le nombre de redémarrages sont enregistrés avant le démarrage, et la terminaison anormale est reproduite en utilisant le signal SIGKILL, qui est une terminaison forcée. La même commande n'est pas appliquée directement aux services en production.

podman inspect lf-course28-web --format '{{.Id}}'
systemctl --user show lf-course28.service -p NRestarts
podman kill --signal KILL lf-course28-web
systemctl --user show lf-course28.service -p ActiveState -p SubState -p NRestarts
podman inspect lf-course28-web --format '{{.Id}}'
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/

Dans le laboratoire source, l'ID du conteneur est passé de 01951ad831a1… à 610769498aeb…, le compteur de service est devenu NRestarts=1, et une requête HTTP distincte a renvoyé le contenu attendu. Immédiatement après l'arrêt, les requêtes peuvent échouer en raison de l'attente d'un redémarrage ou d'un remplacement du conteneur, il faut donc comparer les résultats avec les journaux de service et le statut après stabilisation. Ce paramétrage peut créer un nouveau conteneur à partir des conditions d’exécution générées ; il ne se limite pas à relancer un processus dans le conteneur existant.

systemctl --user stop lf-course28.service
systemctl --user is-active lf-course28.service
podman container exists lf-course28-web
systemctl --user start lf-course28.service

Après un arrêt explicite, il était inactif, et la vérification de l'existence du conteneur a renvoyé le code de sortie 1. Même après 3 secondes, il n'a pas été recréé automatiquement, et il a répondu à nouveau après un redémarrage manuel. Pendant l'exploitation du service, la gestion est basée sur les politiques et le statut de systemd plutôt que sur l'application redondante d'une politique de redémarrage distincte pour Podman. le document systemd.service explique le comportement des conditions de redémarrage et des arrêts manuels.

Vérifiez la persistance après la déconnexion et le démarrage avant la connexion

Démarrez le service, terminez la session SSH et reconnectez-vous sans émettre une autre commande de démarrage. Dans le laboratoire source, HTTP fonctionnait encore à 02:32:48 avec l'heure de démarrage du service inchangée à 02:30:56. Comparer les heures de démarrage aide à distinguer la persistance d’un service démarré récemment lors de la connexion suivante.

systemctl --user show lf-course28.service -p ActiveState -p ActiveEnterTimestamp -p ActiveEnterTimestampMonotonic
loginctl show-user "$(id -un)" -p Linger
curl -fsS http://127.0.0.1:18028/
cat /proc/sys/kernel/random/boot_id
sha256sum "$HOME/lf-course28/site/index.html"
sudo systemctl reboot

Redémarrer déconnectera la session SSH. Effectuez cela uniquement sur une VM de pratique dédiée où l'accès à la console est disponible, et après vous être reconnecté, vérifiez le nouvel ID de démarrage et l’état avant de démarrer manuellement le service. La commande suivante est une requête pour comparer si le service a démarré avant la première connexion.

cat /proc/sys/kernel/random/boot_id
systemctl --user show lf-course28.service -p ActiveState -p SubState -p ActiveEnterTimestampMonotonic -p UnitFileState
loginctl show-session "$XDG_SESSION_ID" -p TimestampMonotonic
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18028/
sha256sum "$HOME/lf-course28/site/index.html"
journalctl --user -u lf-course28.service -b -n 30 --no-pager

Lors de la vérification source, l'identifiant de démarrage avait changé et le service était actif/en fonctionnement. L'horodatage d'activation du service, mesuré en microsecondes depuis ce démarrage, était de 319329250 microsecondes, et le début de la première session SSH était de 361617018 microsecondes. La comparaison au sein du même démarrage montre que le service a démarré environ 42 secondes avant la connexion. Les hachages du document et du fichier Quadlet étaient identiques, et le corps HTTP a été conservé.

Le redémarrage de cette VM a pris au total environ 5 minutes 22 secondes, y compris environ 4 minutes 57 secondes dans la phase du noyau, et l’autotest cbc-aes-aesni a laissé des avertissements rc=-110. La première tentative SSH pendant le délai de démarrage a échoué, et la vérification a été effectuée après avoir confirmé les réponses de la console et que le système était prêt pour la connexion. Le démarrage automatique de Quadlet a été confirmé, mais ce résultat ne doit pas être interprété comme un environnement ayant passé normalement l'auto-vérification du chiffrement. Ne confondez pas la cause du délai de démarrage avec les paramètres de démarrage automatique des services.

Distinction entre les services qui ne sont pas créés et les services qui échouent à démarrer

Unit not found La création a peut-être échoué avant l'exécution du conteneur. Tout d'abord, vérifiez l'extension du fichier .container , le chemin de recherche de l'utilisateur, le nom de la section et les clés prises en charge par la version installée. S'il existe un fichier créé mais que l'exécution échoue, vérifiez le cache de l'image, la source de montage, les ports et les journaux de l'application.

QUADLET_UNIT_DIRS="$HOME/.config/containers/systemd" /usr/lib/systemd/system-generators/podman-system-generator --user --dryrun
systemctl --user cat lf-course28.service
systemctl --user status lf-course28.service --no-pager
journalctl --user -u lf-course28.service -b -n 40 --no-pager
podman ps -a

Le laboratoire source a placé un NotARealKey incorrect dans un dossier de test séparé en dehors du chemin de recherche réel et a seulement effectué une simulation du générateur. Le générateur a retourné le code de sortie 1 et unsupported key et n'a pas créé la commande d'exécution. La simulation limitée aux sources normales a eu le code de sortie 0, et le service est resté actif pendant l'exécution. Vous pouvez diagnostiquer la syntaxe dans un chemin séparé sans corrompre délibérément les fichiers opérationnels.

Après avoir modifié les paramètres d'origine, daemon-reload a pour tâche de relire la définition du service. Pour recréer un conteneur déjà en cours d'exécution avec les nouveaux paramètres, vous devez effectuer systemctl --user restart lf-course28.service en tenant compte du temps d'arrêt nécessaire et recontrôler l'état, la réponse réelle et les données. Toute modification incorrecte doit être rétablie à l'original stocké et reverifiée dans le même ordre.

Désactivation du démarrage automatique et nettoyage de la pratique.

Lors de la suppression de la configuration de la pratique, arrêtez d'abord le service utilisateur. Après avoir déplacé le Quadlet original en dehors du chemin de recherche et effectué un daemon-reload, les fichiers générés et les connexions de cible de démarrage sont également nettoyés. S'il s'agit d'un service qui continuera à fonctionner, n'exécutez pas cette commande de nettoyage.

systemctl --user stop lf-course28.service
mv "$HOME/.config/containers/systemd/lf-course28.container" "$HOME/lf-course28/lf-course28.container.saved"
systemctl --user daemon-reload
systemctl --user show lf-course28.service -p LoadState
podman container exists lf-course28-web
restorecon -RFv "$HOME/lf-course28/site"
ss -lnt 'sport = :18028' 

Le résultat du nettoyage de la source était LoadState=not-found, le code de sortie de la vérification de l'existence du conteneur était 1, et aucun socket n’écoutait sur le port 18028. Les documents ont été laissés intacts, et le contexte SELinux du chemin dédié ayant terminé son utilisation a été rétabli au contexte de fichier général du répertoire personnel. Seuls les répertoires de configuration vides qui n'existaient pas avant la pratique ont été supprimés, et les paramètres utilisateur d'origine ont été maintenus.

Exécutez le bloc suivant uniquement si la valeur initiale était Linger=no et si ce compte n’a besoin d’aucun autre service utilisateur persistant. Si Linger=yes était déjà configuré, conservez-le et omettez ce bloc.

sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger

Après le nettoyage dans le laboratoire source, la valeur Linger=no a été restaurée, et les paramètres locaux existants pour SSH, le pare-feu, Nginx, les hôtes, fstab, le mappage des ID utilisateur et SELinux ont été préservés. Les définitions de services et les documents restent dans le répertoire d’enregistrement dédié pour restauration et révision.