Debian 13 : tutoriel / Exécuter un conteneur Podman sans root et conserver ses données

Dans Debian 13, vous pouvez exécuter Podman en tant qu'utilisateur régulier et créer des conteneurs sans privilèges root. Pour conserver les fichiers nécessaires même après un remplacement, vous devez placer les données persistantes dans un volume distinct de la couche inscriptible propre au conteneur et le relancer avec le même utilisateur et le même volume. Ce tutoriel verrouille l'image officielle httpd par digest et vérifie la réponse ainsi que la préservation des données sur un port en boucle locale.

Séparer les images, les conteneurs et les volumes nommés

Une image est une unité de distribution contenant le programme et les fichiers nécessaires à l'exécution, tandis qu'un conteneur est une instance en cours d'exécution créée à partir d'une image. Les fichiers écrits dans la couche inscriptible du conteneur, en dehors des stockages montés séparément, sont perdus lorsque ce conteneur est supprimé. Les volumes nommés sont des espaces de stockage gérés avec des noms séparés, dont le cycle de vie peut être géré indépendamment du remplacement du conteneur.

« Rootless » signifie fonctionner avec les privilèges d'un utilisateur régulier sur l'hôte. L’identifiant utilisateur (UID, User ID) 0 à l'intérieur du conteneur n'est pas traité de la même manière que root sur l'hôte. Un conteneur rootless peut encore utiliser les ressources disponibles pour cet utilisateur de l'hôte et partage le noyau de l'hôte. Son isolation n'est pas équivalente à une VM séparée. La structure d'exécution de base peut être consultée dans la documentation Podman 5.4.2.

Cible Nom de la pratique Manipulation lors du remplacement
Image digest de docker.io/library/httpd Notez cette empreinte (digest) pour recréer un conteneur avec le même contenu d’image.
Conteneur lf-web27 Arrêter et supprimer, puis en créer un nouveau.
Volume nommé lf-web27-data Préserver lors du remplacement du conteneur et connecter au nouveau conteneur.
Port externe 127.0.0.1:8080 Accessible uniquement depuis la VM Debian, et vérifiez à nouveau après l'exécution.

Vérifier les paquets et la session de l’utilisateur ordinaire

Une VM Debian 13 séparée avec un accès sudo et un réseau pour atteindre le registre d'images est nécessaire. N'effectuez l'installation qu'avec sudo, et par la suite, toutes les commandes podman doivent être exécutées en tant qu'utilisateur régulier connecté. Ne passez pas à sudo podman, car cela accéderait au stockage d'images et de conteneurs séparé de root, ne mélangez donc pas ces deux environnements de stockage pendant le diagnostic.

sudo apt update
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
id
printf '%s\n' "$XDG_RUNTIME_DIR"
grep "^$(id -un):" /etc/subuid /etc/subgid
systemctl --user is-system-running
podman info --format json

Dans l'exercice, nous avons utilisé Podman 5.4.2, un utilisateur régulier avec l'UID et le GID (Group ID, identifiant de groupe) 1000, et le chemin d'exécution /run/user/1000. /etc/subuid et /etc/subgid contenaient chacun lfstudent:100000:65536, et le gestionnaire d'utilisateurs était en cours d'exécution. Cette plage est utilisée lors de la cartographie d'IDs utilisateur supplémentaires pour les conteneurs. Ne copiez pas les plages d'autres comptes pour attribuer des doublons.

podman info a montré host.security.rootless à true, cgroupVersion comme v2, cgroupManager comme systemd, et le stockage sous le répertoire personnel de l'utilisateur en utilisant overlay. S'il y a des erreurs de variables d'environnement ou de connexion au gestionnaire d'utilisateurs, vérifiez à nouveau depuis une vraie session SSH ou une session console de l'utilisateur régulier. Ne falsifiez pas XDG_RUNTIME_DIR avec un chemin quelconque et ne mélangez pas les environnements sudo pour faire apparaître tout comme normal.

Si un nom de laboratoire ou le port 8080 est déjà utilisé, prévoyez de changer le nom de la pratique et le port sans supprimer les ressources existantes. Utilisez une session Bash dédiée pour le laboratoire. Le bloc de préparation permet d'arrêter le script en cas d'erreur ; si une défaillance inattendue termine le shell, inspectez les ressources restantes depuis une nouvelle session utilisateur ordinaire avant de continuer.

set -euo pipefail
if podman container exists lf-web27; then
    echo "A container with this name already exists." >&2
    exit 1
fi
if podman volume exists lf-web27-data; then
    echo "A volume with this name already exists." >&2
    exit 1
fi
if test -e "$HOME/lf-course27-image.txt"; then
    echo "The image record file already exists." >&2
    exit 1
fi
ss -ltn

Sélectionnez l'image officielle et enregistrez son digest

Au lieu d'un nom httpd court, utilisez une adresse qui inclut le registre et l'espace de noms. Guide officiel de l'image Docker httpd a été utilisé pour vérifier et sélectionner le tag, le Dockerfile et le chemin racine web. Il s'agit de l'image officielle Docker pour le serveur Apache HTTP et exécute des programmes à l'intérieur du conteneur qui sont différents de ceux de Nginx sur l'hôte.

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 "Unexpected image reference." >&2; exit 1 ;;
esac
printf '%s\n' "$image" | tee "$HOME/lf-course27-image.txt"
podman image inspect "$image" --format '{{.Architecture}} {{.Os}} {{.Id}}'

Les références enregistrées lors de la vérification sont les suivantes. Lors de l'exécution réelle, utilisez les valeurs obtenues à partir de l'inspection ci-dessus, et si le tag change, un nouveau digest peut apparaître. L'architecture était amd64, et le système d'exploitation était linux.

docker.io/library/httpd@sha256:32e9403360ab2f1047523e72f256527fb9aee68b342abf6ad03f0d629157f3d9

Les tags peuvent se déplacer vers d'autres images, mais le digest est utilisé pour identifier le contenu. Enregistrer le digest ne résout pas automatiquement qui a créé l'image ni ne répond aux vulnérabilités. Les images fixes ne se mettent pas automatiquement à jour avec les derniers correctifs de sécurité, donc le calendrier pour examiner, tester et remplacer les nouvelles versions est géré séparément. Si le pull échoue, distinguez entre l'authentification au registre, les limites de requêtes, le DNS, TLS et les erreurs réseau, et ne lancez pas d'images arbitraires portant le même nom à la place.

Remplir un volume dédié et publier un port sur la boucle locale

Tout d'abord, créez un volume nommé, puis enregistrez index.html avec un conteneur à usage unique. Le conteneur de préparation n'a pas besoin de réseau, il s'exécute donc avec none et est supprimé avec --rm après la sortie. Le volume lui-même reste. Ce volume est destiné à de nouveaux exercices pratiques, il ne remplace donc pas la racine web des services existants.

podman volume create lf-web27-data
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF PODMAN 27\n" > /data/index.html'
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
podman ps
podman port lf-web27
curl --noproxy '*' -fsS http://127.0.0.1:8080/

Le côté gauche de -p est l'adresse et le port de l'hôte, et le côté droit 80 est le port à l'intérieur du conteneur. Spécifier 127.0.0.1 le rend accessible uniquement à l'intérieur de la VM. Le :ro à la fin de -v monte le volume en lecture seule pour ce serveur web. Ce n'est pas un paramètre global qui empêche d'autres conteneurs ou processus de l'hôte d'écrire sur le volume, donc cette étape est distincte de l'étape où le conteneur de préparation écrit dedans.

Le port effectivement exposé était 80/tcp → 127.0.0.1:8080, et la réponse était LF PODMAN 27. S'il s'agit d'immédiatement après le démarrage, réessayez après un court instant. Si le problème persiste, vérifiez les conflits de port avec podman logs lf-web27 et podman inspect lf-web27. Le fait qu'un conteneur soit en cours d'exécution ne signifie pas que le service HTTP a réussi.

Remplacer le conteneur et vérifier la persistance des données

Les étapes suivantes impliquent le stockage du hachage des fichiers de volume et la création d'un fichier de comparaison dans le /tmp du conteneur. Inspect est utilisé pour lire le chemin du volume, mais d'autres répertoires à l'intérieur du stockage de Podman ne sont pas modifiés directement. Après avoir arrêté et supprimé le conteneur, vérifiez si les fichiers du volume restent les mêmes.

point=$(podman volume inspect lf-web27-data --format '{{.Mountpoint}}')
hash_before=$(sha256sum "$point/index.html")
podman exec lf-web27 sh -c 'printf "ephemeral\n" > /tmp/lf-web27-marker'
podman stop lf-web27
podman rm lf-web27
test -f "$point/index.html"
test "$hash_before" = "$(sha256sum "$point/index.html")"
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman exec lf-web27 test ! -e /tmp/lf-web27-marker

Lors de la vérification, la réponse HTTP du nouveau conteneur était la même, et le hachage de index.html était également identique. En revanche, les fichiers /tmp du conteneur précédent n'étaient pas présents dans le nouveau conteneur. Le dernier test n'affiche rien s'il réussit et renvoie un code de sortie 0. À partir de ces résultats, vous pouvez distinguer les différences de durée de vie entre les volumes et les couches d'écriture du conteneur.

Si le nouveau conteneur est lent à se préparer et que curl échoue, vérifiez l'état réel et les journaux, puis essayez à nouveau la requête. Dans un shell qui s'arrête en cas d'erreurs, ne supposez pas que le nettoyage a été effectué ensuite ; vérifiez les ressources restantes avec podman ps -a et podman volume ls. Conserver les volumes est différent d'une sauvegarde. Perdre le répertoire personnel de l'utilisateur ou le disque hôte pourrait également entraîner la perte des mêmes volumes locaux.

Inspecter l'état réel d'AppArmor du conteneur en cours d'exécution

Même si AppArmor est activé sur l'hôte, on ne doit pas supposer que tous les conteneurs rootless sont restreints par un profil appliqué. Avec le conteneur remplacé maintenant en cours d'exécution, comparez les informations d'inspection et l'état réel du processus en utilisant la commande suivante.

podman info --format json
podman inspect lf-web27 --format '{{.AppArmorProfile}}'
podman exec lf-web27 cat /proc/self/attr/current

Dans ce tutoriel, nous avons vérifié pendant que le premier conteneur était en cours d'exécution. Le module AppArmor de l'hôte était Y, mais l'information rootless apparmorEnabled était false, le AppArmorProfile du conteneur était vide, et la sortie du processus était crun (unconfined). Ne pas interpréter ces résultats comme un profil AppArmor en mode enforce appliqué à ce conteneur. Nous n'avons pas désactivé AppArmor ou seccomp, ni ajouté --privileged pour éviter les erreurs.

Comparer les mappages UID de l’hôte et du conteneur

Vérifiez le mappage des ID numériques plutôt que le nom d'utilisateur du conteneur sans privilèges. Dans l'espace de noms par défaut de cet exercice, l’UID 0 du conteneur correspondait à 1000 sur l’hôte, et les UIDs de 1 à 65536 correspondaient à partir de 100000 sur l’hôte. Les groupes avaient la même structure. Cela peut différer avec un autre compte ou avec l’option --userns.

podman unshare cat /proc/self/uid_map /proc/self/gid_map
stat -c '%u:%g' "$point/index.html"
podman unshare stat -c '%u:%g' "$point/index.html"

Le fichier index.html apparaissait comme 1000:1000 sur l’hôte et 0:0 à l’intérieur de podman unshare. Unshare est un outil pour regarder le même fichier du point de vue d’un ID différent dans l’espace de noms utilisateur de Podman, et ce n’est pas une commande qui vous rend root sur l’ensemble de l’hôte. Le manuel podman unshare décrit cette portée de l’espace de noms.

Pour une comparaison supplémentaire, après avoir arrêté le serveur, créez un seul fichier dans le même volume de pratique et définissez-le avec l'UID/GID du conteneur 33. Ce nombre sert à observer la correspondance et ne signifie pas que toutes les images utilisent le même compte de service.

podman stop lf-web27
podman rm lf-web27
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "mapped\n" > /data/mapped.txt; chown 33:33 /data/mapped.txt'
stat -c '%u:%g' "$point/mapped.txt"
podman unshare stat -c '%u:%g' "$point/mapped.txt"

Le résultat réel était hôte 100032:100032, namespace 33:33. Ce n'est pas la même chose que de changer le propriétaire du fichier à 33 sur l'hôte. Pour résoudre les problèmes d'autorisation, nous n'appliquons pas chown à l'ensemble du répertoire utilisateur. L'option :U peut changer de manière récursive la propriété côté hôte, et :z et :Z se rapportent aux labels SELinux, donc elle n'est pas attachée comme solution générale pour les problèmes d'AppArmor. Les effets exacts des options de volume peuvent être vérifiés dans options de volume et de sécurité de Podman run.

Supprimez uniquement le volume du laboratoire et conservez l'enregistrement de l'image

Si vous avez effectué la comparaison des identifiants ci-dessus, lf-web27 a déjà été arrêté et supprimé. Confirmez ceci dans podman ps -a avant de supprimer son volume. Si vous avez sauté cette comparaison et que le conteneur du laboratoire existe encore, arrêtez-le avec podman stop lf-web27 et supprimez-le avec podman rm lf-web27. Ne forcez pas la suppression d'un volume en cours d'utilisation.

La suppression des volumes dédiés restants dans cet exercice supprimera également leurs données. Déterminez d'abord si des fichiers doivent être préservés, puis supprimez uniquement le nom spécifique. La portée de la création et de la gestion des volumes nommés peut être vérifiée dans documentation de création de volume Podman.

podman ps -a
podman volume inspect lf-web27-data
podman volume rm lf-web27-data
podman volume ls
ss -ltn

Lors du nettoyage réel, seuls le conteneur lf-web27 et le volume lf-web27-data ont été supprimés. Les images reçues et les enregistrements de digest de lf-course27-image.txt ont été conservés, et prune, qui supprime d'autres images et volumes en masse, n'a pas été utilisé. En décidant séparément de conserver ou non les données persistantes et les informations de reproduction des images, on peut éviter de confondre le nettoyage des exercices avec la suppression des données opérationnelles.