Tutorial de Debian 13 / Ejecutar contenedores Podman sin root y conservar datos en volúmenes
En Debian 13, puede ejecutar Podman como un usuario regular y crear contenedores sin privilegios de root. Para conservar los archivos necesarios incluso después de reemplazarlos, necesita guardar los datos persistentes en un volumen separado de la capa escribible del contenedor y volver a ejecutarlo con el mismo usuario y el mismo volumen. Este tutorial fija la imagen oficial httpd por su digest (identificador del contenido) y verifica la respuesta y la preservación de datos en un puerto de loopback.
Separe imágenes, contenedores y volúmenes con nombre
Una imagen es una unidad de distribución que contiene el programa y los archivos necesarios para la ejecución, mientras que un contenedor es una instancia en ejecución creada a partir de una imagen. Los archivos escritos en la capa editable del contenedor, fuera del almacenamiento montado por separado, se pierden cuando ese contenedor se elimina. Los volúmenes con nombre son espacios de almacenamiento gestionados con nombres separados, cuyo ciclo de vida puede gestionarse independientemente de la sustitución del contenedor.
Rootless significa ejecutar con privilegios de usuario regular en el host. El identificador de usuario (UID, User ID) 0 dentro del contenedor no se trata de la misma manera que root en el host. Un contenedor rootless aún puede usar los recursos disponibles para ese usuario del host y comparte el kernel del host. Su aislamiento no es equivalente al de una VM separada. La estructura básica de ejecución se puede consultar en la documentación de Podman 5.4.2.
| Objetivo | Nombre de la práctica | Manejo durante el reemplazo |
|---|---|---|
| Imagen | digest de docker.io/library/httpd | Registre el digest para recrear un contenedor con el mismo contenido de la imagen. |
| Contenedor | lf-web27 | Detener y eliminar, luego crear uno nuevo. |
| Volumen nombrado | lf-web27-data | Conservar durante el reemplazo del contenedor y conectar al nuevo contenedor. |
| Puerto externo | 127.0.0.1:8080 | Accesible solo dentro de la VM de Debian, y verifique nuevamente después de ejecutar. |
Verifique los paquetes y la sesión del usuario normal
Se requiere una VM separada de Debian 13 con acceso sudo y una red para alcanzar el registro de imágenes. Solo realice la instalación con sudo, y después, todos los comandos de podman se ejecutan como el usuario normal que ha iniciado sesión. No cambie a sudo podman, porque esto accedería al almacenamiento de imágenes y contenedores separado del root, no mezcle ambos entornos de almacenamiento durante el diagnóstico.
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
La prueba original utilizó Podman 5.4.2, un usuario regular con UID y GID (Group ID, identificador del grupo) 1000, y la ruta de ejecución /run/user/1000. /etc/subuid y /etc/subgid contenían cada uno lfstudent:100000:65536, y el gestor de usuarios estaba en ejecución. Este rango se usa al mapear IDs de usuarios adicionales en contenedores. No copie rangos de otras cuentas para asignar duplicados.
podman info mostró host.security.rootless como true, cgroupVersion como v2, cgroupManager como systemd, y el almacenamiento bajo el directorio home del usuario usando overlay. Si hay errores de variables de entorno o de conexión del gestor de usuarios, verifique de nuevo desde una sesión real de SSH o de consola del usuario regular. No asigne a XDG_RUNTIME_DIR una ruta arbitraria ni mezcle entornos sudo para que parezca normal.
Si algún nombre de laboratorio o el puerto 8080 ya están en uso, planifique cambiar el nombre del laboratorio y el puerto sin eliminar los recursos existentes. Use una sesión de Bash dedicada para el laboratorio. El bloque de preparación habilita la detención por errores; si un fallo inesperado cierra la terminal, inspeccione los recursos restantes desde una nueva sesión de usuario común antes de continuar.
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
Seleccione la imagen oficial y registre su digest
En lugar de un nombre corto httpd, use una dirección que incluya el registro y el espacio de nombres. httpd Guía de la Imagen Oficial de Docker se utilizó para verificar y seleccionar la etiqueta, Dockerfile y la ruta raíz web. Esta es la Imagen Oficial de Docker para Apache HTTP Server y ejecuta programas dentro del contenedor que son diferentes del Nginx del host.
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}}'
Las referencias registradas durante la verificación son las siguientes. En la ejecución real, use los valores obtenidos de la inspección anterior, y si la etiqueta cambia, puede aparecer un nuevo digest. La arquitectura era amd64 y el sistema operativo era linux.
docker.io/library/httpd@sha256:32e9403360ab2f1047523e72f256527fb9aee68b342abf6ad03f0d629157f3d9
Las etiquetas pueden moverse a otras imágenes, pero el digest se utiliza para identificar el contenido. Registrar el digest no resuelve automáticamente quién creó la imagen ni responde a vulnerabilidades. Las imágenes fijas no se actualizan automáticamente con los últimos parches de seguridad, por lo que el calendario para revisar, probar y reemplazar nuevas versiones se gestiona por separado. Si falla la extracción, distinga entre autenticación del registro, límites de solicitudes, DNS, TLS y errores de red, y no ejecute imágenes arbitrarias con el mismo nombre en su lugar.
Prepare un volumen dedicado y publique un puerto en loopback
Primero, cree un volumen con nombre y escriba index.html con un contenedor de una sola vez. El contenedor de preparación no necesita red, por lo que se ejecuta con none y se elimina con --rm después de salir. El volumen en sí permanece. Este volumen es para fines de práctica nuevos, por lo que no sobrescribe la raíz web de los servicios existentes.
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/
El lado izquierdo de -p es la dirección y el puerto del host, y el lado derecho 80 es el puerto dentro del contenedor. Especificar 127.0.0.1 hace que sea accesible solo dentro de la VM. El :ro al final de -v monta el volumen como de solo lectura para este servidor web. No es una configuración global que impida a otros contenedores o procesos del host escribir en el volumen, por lo que esta etapa se distingue de la etapa donde el contenedor de preparación escribe en él.
La salida real del puerto fue 80/tcp → 127.0.0.1:8080, y la respuesta fue LF PODMAN 27. Si es justo después del arranque, repita la solicitud después de un corto tiempo. Si continúa fallando, verifique los conflictos de puertos con podman logs lf-web27 y podman inspect lf-web27. Que un contenedor esté en ejecución no significa que el servicio HTTP haya tenido éxito.
Sustituya el contenedor y verifique la persistencia de los datos
Los siguientes pasos implican almacenar el hash de los archivos del volumen y crear un archivo de comparación en /tmp del contenedor. Se utiliza podman volume inspect para consultar la ruta del volumen, pero otros directorios dentro del almacenamiento de Podman no se modifican directamente. Después de detener y eliminar el contenedor, verifique si los archivos en el volumen permanecen igual.
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
En la prueba original, la respuesta HTTP del nuevo contenedor fue la misma, y el hash de index.html también era idéntico. Por otro lado, los archivos /tmp del contenedor anterior no estaban presentes en el nuevo contenedor. La última prueba no imprime nada si tiene éxito y devuelve el código de salida 0. A partir de estos resultados, se pueden distinguir las diferencias de duración entre los volúmenes y las capas escribibles del contenedor.
Si el nuevo contenedor tarda en estar listo y curl falla, verifique el estado real y los registros e intente la solicitud nuevamente. En un shell que se detiene ante errores, no asuma que la limpieza se realizó después; revise los recursos restantes con podman ps -a y podman volume ls. Conservar volúmenes es diferente de hacer una copia de seguridad. Perder el directorio home del usuario o del disco del host también podría resultar en la pérdida de los mismos volúmenes locales.
Inspeccione el estado real de AppArmor del contenedor en ejecución
Incluso si AppArmor está habilitado en el host, no se debe asumir que todos los contenedores sin root están restringidos por un perfil aplicado. Con el contenedor reemplazado ya en ejecución, compare la información de inspección y el estado real del proceso usando el siguiente comando.
podman info --format json
podman inspect lf-web27 --format '{{.AppArmorProfile}}'
podman exec lf-web27 cat /proc/self/attr/current
El registro de la prueba original se obtuvo con el primer contenedor en ejecución; puede repetir la consulta en el contenedor sustituido antes de detenerlo. El módulo AppArmor del host era Y, pero la información sin root mostraba apparmorEnabled como false, el AppArmorProfile del contenedor estaba vacío, y la salida del proceso era crun (unconfined). No interprete estos resultados como que se está aplicando un perfil de AppArmor en modo enforce a este contenedor. No deshabilitamos AppArmor ni seccomp, ni agregamos --privileged para evitar errores.
Compare los mapeos UID del host y del contenedor
Verifique el mapeo de ID numérico en lugar del nombre de usuario del contenedor sin root. En el espacio de nombres predeterminado de esta práctica, el UID 0 del contenedor correspondía a 1000 del host, y los UID del 1 al 65536 correspondían al host a partir del 100000. Los grupos tenían la misma estructura. Puede diferir con una cuenta diferente o con la opción --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"
El index.html aparecía como 1000:1000 en el host y 0:0 dentro de podman unshare. Unshare es una herramienta para ver el mismo archivo desde la perspectiva de un ID diferente dentro del espacio de nombres de usuario de Podman, y no es un comando que le dé privilegios de root en todo el host. El manual podman unshare describe este alcance del espacio de nombres.
Para una comparación adicional, después de detener el servidor, cree un solo archivo en el mismo volumen de práctica y asígnelo al UID/GID de contenedor 33. Este número es para observar el mapeo y no significa que todas las imágenes usen la misma cuenta de servicio.
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"
El resultado real fue host 100032:100032, espacio de nombres 33:33. Esto no es lo mismo que cambiar el propietario del archivo a 33 en el host. Para resolver problemas de permisos, no aplicamos chown a todo el directorio personal del usuario. La opción :U puede cambiar la propiedad recursivamente en el lado del host, y :z y :Z se relacionan con las etiquetas de SELinux, por lo que no se adjunta como una solución general para problemas de AppArmor. Los efectos exactos de las opciones de volumen se pueden verificar en Opciones de volúmenes y seguridad de Podman run.
Elimine solo el volumen del laboratorio y conserve el registro de la imagen
Si completó la comparación de mapeo anterior, lf-web27 ya se ha detenido y eliminado. Confirme esto en podman ps -a antes de eliminar su volumen. Si omitió esa comparación y el contenedor del laboratorio aún existe, deténgalo con podman stop lf-web27 y elimínelo con podman rm lf-web27. No fuerce la eliminación de un volumen en uso.
Eliminar los volúmenes dedicados restantes en este ejercicio también eliminará sus datos. Primero, determine si se deben conservar archivos, luego elimine solo el nombre específico. El alcance de la creación y administración de volúmenes con nombre se puede verificar en la documentación de Podman volume create.
podman ps -a
podman volume inspect lf-web27-data
podman volume rm lf-web27-data
podman volume ls
ss -ltn
En la limpieza de la prueba original, solo se eliminaron el contenedor lf-web27 y el volumen lf-web27-data. Se conservaron las imágenes recibidas y los registros de digest de lf-course27-image.txt, y no se utilizó prune, que elimina otras imágenes y volúmenes en bloque. Al decidir por separado si se conserva la información persistente y la de reproducción de imágenes, se puede evitar confundir la limpieza de ejercicios con la eliminación de datos operativos.




