Tutorial de Debian 13 / Gestionar contenedores rootless con Quadlet y comprobar el arranque sin sesión
Para operar contenedores sin root como servicios de usuario en Debian 13, se crea el Quadlet original y se gestionan los servicios generados por el systemd de usuario. El reinicio tras una terminación anormal, la detención explícita, la persistencia después del cierre de sesión y el inicio automático al arrancar son condiciones diferentes, por lo que cada una debe verificarse por separado. En esta práctica, se crean contenedores web y volúmenes separados, preservamos el valor original de linger y luego verificamos la respuesta HTTP.
Distinga los archivos fuente de Quadlet de los servicios generados
Quadlet es una función de Podman que lee archivos con extensiones como .container para generar servicios systemd. Los usuarios ordinarios usualmente colocan la fuente en ~/.config/containers/systemd y la gestionan con systemctl --user. Si modifica un archivo .service generado directamente bajo /run/user/UID/systemd/generator, desaparecerá al regenerarse, por lo que debe corregir el archivo original.
La prueba original se ejecutó en un entorno Podman 5.4.2, cgroup v2, con gestor de usuario systemd. Según la documentación de Quadlet de Podman 5.4.2, usamos las claves soportadas Image, ContainerName, PublishPort, Volume y Pull. Para evitar problemas donde los servicios no se generan al usar directamente claves de documentación más reciente, primero verifique la versión instalada y la salida del generador.
El servicio generado no es algo que se gestione mediante systemctl enable como un archivo de servicio permanente normal. Si escribe WantedBy=default.target en la sección [Install] del archivo original, el generador crea un enlace al objetivo predeterminado del usuario. No intente cambiar de cuenta añadiendo User= en un archivo original sin root; trabaja como el usuario normal real en su lugar.
Preparar la sesión de usuario, la imagen y el volumen dedicado
Use el entorno normal de Podman del usuario verificado en la lección anterior. Solo las instalaciones de paquetes se realizan con sudo, y los siguientes comandos de podman y systemctl --user se ejecutan como un usuario normal. El puerto 8080 y el nombre lf-web28 deben estar disponibles. Este ejemplo utiliza lf-web28-data, que es diferente del volumen de la lección anterior.
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
En una nueva terminal de Bash, ejecute el siguiente bloque de preparación. Linger se aplica a todo el administrador de usuario de la cuenta, así que considere el alcance del mantenimiento antes de usarlo en una cuenta con otros servicios de usuario. Mantenga un registro separado del valor original para evitar cambiar una cuenta que originalmente era yes a no durante la limpieza.
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"
Este ejercicio obtiene la imagen por adelantado y utiliza un digest. Pull=never en el servicio evita que intente descargarla al iniciar, por lo que si la imagen no está local, el inicio fallará. No asuma que se recuperará automáticamente incluso si la imagen se elimina; establezca procedimientos para la retención y actualización de imágenes juntos. La raíz web de la imagen oficial httpd se puede consultar en guía de imágenes httpd.
Escriba el archivo Quadlet completo e inspeccione la salida del generador
Guarde toda la configuración a continuación en la misma terminal. Dado que el CONF del heredoc no está entre comillas, la $image definida previamente se expandirá al digest real. Este archivo es la configuración para ese usuario.
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
| Configuraciones | Significado |
|---|---|
| PublishPort=127.0.0.1:8080:80 | Publique el puerto solo en la interfaz de loopback de la VM. |
| Volume=...:ro | Monte el volumen de datos web como solo lectura. |
| Restart=on-failure | Solicite a systemd reiniciar los servicios que salieron debido a un fallo. |
| RestartSec=2 | Esperar entre reinicios. Esto no elimina el límite para fallos repetidos. |
| TimeoutStartSec=180 | Establecer un límite de tiempo para esperar a que el servicio se inicie. Esto no verifique el estado de disponibilidad HTTP. |
| WantedBy=default.target | El generador se conecta para iniciar desde el objetivo predeterminado del gestor de usuarios. |
Antes de leer una nueva fuente, revise la salida del generador en el directorio restringido y realice daemon-reload. --dryrun es una función para ver el contenido generado y no inicia el contenedor.
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
En esta VM, SourcePath era lf-web28.container en el directorio home, y FragmentPath era /run/user/1000/systemd/generator/lf-web28.service. El archivo generado incluía comandos de ejecución/limpieza de Podman y el digest de la imagen. Si el servicio no existe, compruebe la ruta de origen, la extensión del archivo, las claves compatibles y los errores del generador, y no cree ni sobrescriba manualmente el archivo generado.
Habilite linger, inicie el servicio y compruebe HTTP
Habilitar linger inicia el gestor de usuario de esta cuenta al arrancar y lo mantiene disponible después de cerrar sesión. Como explica el manual de loginctl de Debian, esto afecta al gestor de usuario de la cuenta, además de a este servicio. En el laboratorio registrado, linger era inicialmente no y se cambió a yes únicamente para la verificación.
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 respuesta esperada es LF QUADLET 28. active significa que el servicio generado está activo, y no equivale a que HTTP esté listo. En la verificación, una solicitud inmediatamente después del inicio falló con "Empty reply from server" pero tuvo éxito después de que estuvo listo. No atribuya todos los fallos a un retraso en la disponibilidad; intente la solicitud nuevamente poco después, y si sigue fallando, verifique los siguientes registros y el estado de los puertos y volúmenes.
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
Compare los reinicios por fallos con una detención explícita
La siguiente comparación se limita a contenedores de práctica dedicados que solo proporcionan archivos estáticos. No aplique pruebas de terminación forzada tal como están a servicios de escritura reales, como bases de datos. Primero, registre el ID del contenedor y el recuento de reinicios, luego envíe una señal KILL para producir una terminación por fallo.
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/
En la verificación, NRestarts aumentó, el ID del contenedor cambió y las respuestas HTTP volvieron a tener éxito. Los 3 segundos son un ejemplo para iniciar la verificación y no garantizan el tiempo de recuperación en todos los entornos. Si los fallos repetidos alcanzan el límite, corrija la causa encontrada en el registro, luego haga reset-failed y reinicie solo el servicio afectado. Los recuentos de reinicio pueden ser restablecidos por reinicios de administrador y no se utilizan tal como están para estadísticas de fallos a largo plazo.
Ahora solicite explícitamente una detención en systemd. Tener Restart=on-failure no significa que el servicio se reiniciará automáticamente después de una solicitud de detención por parte de un administrador. Las condiciones de la política siguen explicación del reinicio del servicio 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/
Después de detenerse, el resultado fue inactive y el contenedor dedicado también fue eliminado. El ejemplo se detiene con un error si permanece activo, y si se detiene normalmente, verifique ActiveState=inactive antes de reiniciar. Si una respuesta no está lista inmediatamente después de iniciar, verifique el estado y los registros como se describe en la sección anterior y vuelva a intentar la solicitud. Los volúmenes permanecen independientemente de la eliminación del contenedor.
Verificar el inicio antes de iniciar sesión y la persistencia después de cerrar sesión
Después de reiniciar, inicie sesión por SSH con el mismo usuario, y que el servicio esté activo por sí solo no prueba el inicio automático antes del inicio de sesión. Esto se debe a que los servicios gestionados por el usuario podrían iniciarse durante el proceso de inicio de sesión. En este tutorial, se programó una prueba HTTP de solo lectura como root, que no depende de los servicios de usuario, para registrar respuestas y listas de sesiones en momentos en que no existe ninguna sesión de inicio de sesión.
Para verificar de la misma manera, después de confirmar que no existen las rutas dedicadas que se indican a continuación, se puede preparar una prueba de gestión root. No modifica temporizadores ni registros existentes en otros servidores. Incluso si el código se ejecuta como root, realiza solicitudes HTTP GET y consultas de sesión y escribe su propio registro de evidencia exclusivo para root; no añade dependencias como 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
Primero, pruebe si se mantiene después de cerrar sesión. Si la programación a continuación tiene éxito, cierre sesión de todas las sesiones interactivas del usuario objetivo, espere al menos 70 segundos y luego inicie sesión nuevamente para leer los datos registrados. Mantener la sesión abierta inmediatamente después de la programación no es una verificación de cierre de sesión. Si permanece una unidad transitoria con el mismo nombre, verifique el estado existente y evite la ejecución duplicada.
sudo systemd-run --unit=lf-logout28-probe --on-active=15s --timer-property=AccuracySec=1s /usr/local/sbin/lf-boot28-probe logout
La sonda registra la lista de sesiones antes de su bucle de reintentos, por lo que esa lista por sí sola es insuficiente si inicia sesión mientras todavía está intentando. Después de reconectarse, inspeccione sudo journalctl -b -u lf-logout28-probe.service --no-pager y compara la hora de finalización exitosa del trabajo con la hora de inicio de sesión mostrada por loginctl session-status. Utilice la consulta de diario equivalente para lf-boot28-probe.service después del reinicio. Acepte la evidencia solo si la sonda tuvo éxito y terminó antes de que el usuario objetivo iniciara sesión. Tenga en cuenta los desfases de zona horaria al comparar la marca de tiempo UTC del archivo con las horas del diario/sesión. Las esperas de 70/90 segundos permiten los reintentos limitados de la sonda bajo carga ordinaria; el tiempo transcurrido por sí solo no es prueba.
Después de iniciar sesión nuevamente, verifique la hora de la sonda, la lista de sesiones y HTTP_PROBE_PASSED usando el siguiente comando. Distinga entre la sesión del usuario de la clase manager y la sesión de inicio de sesión real de la clase user. Si había otra sesión de usuario en ejecución en el momento en que se ejecutó la sonda, no se utiliza como evidencia para mantener la sesión después de cerrar sesión.
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
Los siguientes son los pasos para reiniciar normalmente la VM después de verificar el acceso a la consola y el impacto en otros servicios en funcionamiento. Anote el ID de arranque antes de comenzar, y después de reiniciar, mantenga a ese usuario desconectado durante al menos 90 segundos. Acceder antes de que transcurra el temporizador puede confundir los resultados, así que compare también la hora registrada con la hora de inicio de sesión real.
cat /proc/sys/kernel/random/boot_id
sudo systemctl reboot
Después de iniciar sesión nuevamente, verifique si el nuevo ID de arranque es diferente del anterior y lea los registros de ese arranque. Si no hay registro o si falló, no se considera un inicio automático exitoso.
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/
En la VM de la prueba original, HTTP tuvo éxito alrededor de 46 segundos después del nuevo arranque cuando solo existía la sesión de clase manager y el estado era lingering. Una prueba de cierre de sesión por separado también tuvo éxito cuando no había una sesión de usuario real. La sonda inicial programada con la precisión de temporizador predeterminada no se utilizó como evidencia porque se superpuso con el reingreso para la verificación, y se volvió a comprobar especificando AccuracySec=1s. El criterio es si los resultados permanecieron antes del inicio de sesión y no el tiempo exacto de ejecución.
Elimine el archivo fuente y el volumen y restaure el valor de linger
systemctl --user stop detiene la ejecución actual, pero si el original con [Install] permanece, puede volver en el próximo inicio del gestor de usuarios. Para eliminar la configuración de práctica, elimine el original correspondiente y ejecute daemon-reload para limpiar los enlaces generados. El primer bloque a continuación debe ejecutarse como un usuario normal.
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
Eliminar volúmenes significa eliminar datos, así que primero guarde cualquier contenido necesario. Luego, elimine solo los temporizadores y scripts del sistema de práctica. Los registros de evidencia se pueden dejar en una ruta de copia de seguridad accesible solo para 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
En la limpieza de la prueba original, se eliminaron los servicios originales dedicados creados, los contenedores, volúmenes y sondas; se cerró el puerto 8080 y linger volvió a su configuración original de 'no'. Se preservaron las imágenes existentes y otros servicios. Al decidir si continuar ejecutando servicios regulares de usuario, gestione la duración de las cuentas, la retención de datos y los procedimientos de actualización y restauración juntos.




