Rocky Linux 10: tutorial / Gestionar contenedores con Quadlet y arranque automático sin root
Para operar contenedores Podman como un servicio en Rocky Linux 10, puede declarar las condiciones de ejecución en un archivo Quadlet y dejar que systemd gestione el inicio, la detención y el reinicio. Para el arranque automático de contenedores de usuarios normales al iniciar, debe verificar el objetivo de arranque del Quadlet y la configuración de linger que mantiene el administrador de usuario incluso sin iniciar sesión.
Relación entre Quadlet y los servicios de usuario
Quadlet es una característica de Podman que describe las condiciones de contenedores, como imágenes, puertos y volúmenes, en un archivo. El generador de systemd lee este archivo para crear un archivo de servicio regular, y luego es gestionado por systemctl. Más allá de registrar comandos largos de podman run, puede manejar la política de reinicio del servicio y el objetivo de inicio juntos.
El laboratorio de origen utilizó el usuario regular lfstudent en Rocky Linux 10.2 con Podman 5.8.2, systemd 257, gestión de recursos con cgroups v2 y SELinux en modo Enforcing. Reutilice la imagen oficial de Nginx verificada en la lección de Podman sin privilegios y contenido local, publicando solo en 127.0.0.1:18028. Este Quadlet se ejecuta como un servicio de usuario; distinga sus comandos de los comandos sudo systemctl que gestionan servicios del sistema.
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
El valor rootless debería ser true, y cgroups deberían ser v2. Si existen servicios, contenedores o materiales con el mismo nombre, no los sobrescriba con nuevos ajustes, sino verifíquelos primero. El linger existente de esta máquina virtual era no, y para la práctica, se cambió a yes únicamente para ese usuario y se restauró al final.
Confirme las opciones compatibles de acuerdo con la versión instalada. Documentación de la serie Podman 5.8 Quadlet explica la ruta de búsqueda del usuario, el método de creación y la correspondencia de cada ajuste. No asuma que las nuevas opciones en la documentación más reciente son compatibles con los paquetes de distribuciones anteriores.
Después de revisar los servicios de usuario gestionados por esta cuenta, configure linger solo para el usuario respectivo. Esta no es una opción para un contenedor único, sino que afecta la duración del administrador de usuarios de esa cuenta. Las cuentas que ya tenían Linger=yes deben conservar ese valor al final de la práctica.
sudo loginctl enable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
El manual de loginctl explica que linger es una función que inicia el administrador de usuarios al arrancar y lo mantiene activo incluso después de cerrar sesión.
Ruta del documento y preparación del archivo Quadlet completo
Lo siguiente se ejecuta en una consola de usuario normal. El directorio de datos lf-course28 se ha creado recientemente, reutilizando las referencias de imágenes registradas en la Lección 27. Si la Lección 27 no se realizó, debe descargar la imagen oficial y verificar la fuente y el digest para preparar primero el mismo archivo de referencia.
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"
Guarde el siguiente contenido completo en ~/.config/containers/systemd/lf-course28.container. La ruta de inicio aquí es la ruta del usuario que realiza la práctica. Si se ejecuta con otra cuenta, modifique la ruta de origen de Volume para que coincida con esa cuenta y especifique la referencia de la imagen con el valor que haya confirmado.
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
| Sección · Configuración | Rol en este servicio |
|---|---|
[Container] |
Estos son los requisitos de ejecución de Podman, como imagen, nombre, puerto y montaje. |
Pull=never |
Utiliza una imagen guardada localmente que ya ha sido verificada. Si no está en la caché, el inicio fallará, así que prepárela con anticipación. |
Volume=…:ro,Z |
Proporcione nuevos documentos dedicados en modo de solo lectura y aplique el contexto SELinux adecuado para el contenedor. |
Restart=on-failure |
Reinicie el servicio cuando termine de manera anormal. Esto se distingue de una detención explícita. |
WantedBy=default.target |
Vincule el servicio al objetivo de inicio predeterminado del administrador de usuarios. |
Dado que esta no es una configuración que rastree automáticamente las etiquetas temporales de la imagen, la actualización implica revisar el nuevo digest, cambiar el archivo y luego verificarlo nuevamente. Solo se utilizan nuevas rutas dedicadas para los montajes, y no monte ni reasigne etiquetas a todo el directorio home.
Creación del servicio, ejecución y verificación HTTP real.
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
El servicio realmente creado estaba en /run/user/1000/systemd/generator/lf-course28.service, y su estado era generated. El archivo creado contenía comandos de ejecución del contenedor y comandos de detención/limpieza. No edite este archivo directamente; modifique el archivo original .container y vuelva a crearlo ejecutando daemon-reload.
Este servicio estaba activo/en ejecución y devolvió LF28 Quadlet service works. El tipo predeterminado del servicio creado es notify, y el programa de monitoreo de contenedores conmon indica su inicio, pero esto por sí solo no se considera suficiente para determinar que la aplicación web responde correctamente. La respuesta HTTP real y el contenido esperado se verifican por separado. Se observó un restablecimiento de conexión una vez inmediatamente después del inicio, por lo que se utilizaron reintentos limitados.
No se utiliza el método de aplicar systemctl --user enable lf-course28.service al servicio creado como un archivo normal. El generador de Quadlets maneja los ajustes [Install] del archivo original. Las condiciones bajo las cuales el propio administrador de usuarios se inicia en el arranque deben verificarse por separado.
Compare la terminación anormal con una detención explícita.
La prueba tiene como objetivo únicamente el contenedor creado en este tutorial. Se registran el ID del contenedor y el número de reinicios antes del inicio, y la terminación anormal se reproduce utilizando la señal SIGKILL, que es una terminación forzada. El mismo comando no se aplica directamente a los servicios de producción.
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/
En el laboratorio fuente, el ID del contenedor cambió de 01951ad831a1… a 610769498aeb…, el contador de servicio se volvió NRestarts=1, y una solicitud HTTP separada devolvió el contenido esperado. Justo después de la detención, las consultas pueden fallar debido a la espera de un reinicio o reemplazo del contenedor, por lo que compare los resultados junto con los registros de servicio y el estado después de la estabilización. Esta configuración no solo preserva los procesos dentro del mismo contenedor, sino que también permite crear un nuevo contenedor bajo las condiciones de ejecución generadas.
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
Después de detenerse explícitamente, estaba inactivo, y la verificación de existencia del contenedor devolvió el código de salida 1. Incluso después de 3 segundos, no se recreó automáticamente, y respondió nuevamente después de iniciarlo manualmente. Durante la operación del servicio, la gestión se basa en las políticas y el estado de systemd en lugar de aplicar de manera redundante una política de reinicio separada para Podman. el documento systemd.service explica el comportamiento de las condiciones de reinicio y las detenciones manuales.
Verificar la persistencia después de cerrar sesión y al iniciar antes de iniciar sesión
Inicie el servicio, termine la sesión SSH y vuelva a conectarse sin emitir otro comando de inicio. En el laboratorio de origen, HTTP todavía funcionaba a las 02:32:48 con la hora de inicio del servicio sin cambios a las 02:30:56. Comparar los tiempos de inicio ayuda a distinguir la persistencia de un servicio iniciado recientemente por el siguiente inicio de sesión.
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
Reiniciar desconectará la conexión SSH. Realice esto solo en una máquina virtual de práctica dedicada donde haya acceso a la consola, y después de reconectarse, verifique el nuevo ID de arranque y el estado antes de iniciar el servicio manualmente. El siguiente comando es una consulta para comparar si el servicio se inició antes del primer inicio de sesión.
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
En la verificación de la fuente, el ID de arranque había cambiado y el servicio estaba activo/en ejecución. La marca de tiempo de activación del servicio, medida en microsegundos desde ese arranque, fue de 319329250 microsegundos, y el inicio de la primera sesión SSH fue de 361617018 microsegundos. Comparando dentro del mismo arranque, se observa que el servicio se inició aproximadamente 42 segundos antes del inicio de sesión. Los hashes del documento y del archivo Quadlet eran los mismos, y el cuerpo HTTP se mantuvo.
El reinicio de esta VM tomó un total de aproximadamente 5 minutos y 22 segundos, incluyendo aproximadamente 4 minutos y 57 segundos en la fase del kernel, y la autoprueba de cbc-aes-aesni dejó advertencias rc=-110. El primer intento de SSH durante la demora en el arranque falló, y la verificación se realizó después de confirmar las respuestas de la consola y que el sistema estaba listo para la conexión. Se confirmó el autoarranque de Quadlet, pero este resultado no debe interpretarse como un entorno que pasó la autoinspección de cifrado normalmente. No mezcle la causa de la demora en el arranque con la configuración de autoarranque del servicio.
Distinción entre servicios que no se crean y servicios que no logran iniciarse
Unit not found La creación puede haber fallado antes de la ejecución del contenedor. Primero, verifique la extensión del archivo .container , la ruta de búsqueda del usuario, el nombre de la sección y las claves compatibles con la versión instalada. Si hay un archivo creado pero la ejecución falla, verifique la caché de imágenes, la fuente de montaje, los puertos y los registros de la aplicación.
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
El laboratorio de origen colocó un NotARealKey incorrecto en una carpeta de prueba separada fuera de la ruta de búsqueda real y solo realizó una ejecución de prueba del generador. El generador devolvió el código de salida 1 y unsupported key y no creó el comando de ejecución. La ejecución de prueba limitada a fuentes normales tuvo un código de salida 0, y el servicio permaneció activo durante la ejecución. Puede diagnosticar la sintaxis en una ruta separada sin corromper deliberadamente archivos operativos.
Después de cambiar la configuración original, daemon-reload es la tarea de volver a leer la definición del servicio. Para recrear un contenedor que ya está en ejecución con la nueva configuración, necesita realizar systemctl --user restart lf-course28.service considerando el tiempo de inactividad necesario y volver a verificar el estado, la respuesta actual y los datos. Cualquier modificación incorrecta debe revertirse a la original almacenada y volver a verificarse en el mismo orden.
Deshabilitar el inicio automático y limpiar la práctica.
Al eliminar la configuración de la práctica, primero detenga el servicio del usuario. Después de mover el Quadlet original fuera de la ruta de búsqueda y ejecutar daemon-reload, también se limpian los archivos generados y las conexiones del objetivo de inicio. Si es un servicio que continuará operando, no ejecute este comando de limpieza.
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'
El resultado de la limpieza de la fuente fue LoadState=not-found, el código de salida de la verificación de existencia del contenedor fue 1, y no había ningún socket a la escucha en el puerto 18028. Los documentos se dejaron intactos, y el contexto SELinux de la ruta dedicada que había terminado de usarse se revirtió al contexto de archivos del hogar general. Solo se eliminaron los directorios de configuración vacíos que no existían antes de la práctica, y se mantuvieron las configuraciones de usuario originales.
Ejecute el siguiente bloque únicamente si el valor original era Linger=no y esta cuenta no necesita otros servicios de usuario persistentes. Si ya tenía Linger=yes, consérvelo y omita el bloque.
sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
Después de la limpieza en el laboratorio de origen, se restauró a no, y se conservaron la configuración existente de SSH, firewall, Nginx, hosts, fstab, mapeo de ID de usuario y ajustes locales de SELinux. Las definiciones de servicio y materiales permanecen en el directorio de registro dedicado para restauración y revisión.




