Rocky Linux 10 教程 / 使用Quadlet管理rootless Podman服务并验证开机启动

要在 Rocky Linux 10 上将 Podman 容器作为服务运行,可以在 Quadlet 文件中声明运行条件,并让 systemd 管理启动、停止和重启。要在启动时自动启动普通用户容器,需要检查 Quadlet 的启动目标以及在未登录时保持用户管理器的 linger 设置。

Quadlet 与用户服务之间的关系

Quadlet 是 Podman 的一个功能,它在文件中描述容器的条件,如镜像、端口和卷。systemd 的生成器读取此文件以创建常规服务文件,然后由 systemctl 进行管理。除了记录长期的 podman run 命令外,它还可以管理服务的重启策略和启动目标。

原实验使用Rocky Linux 10.2、普通用户lfstudent、Podman 5.8.2、systemd 257、cgroups v2和SELinux强制模式。复用rootless Podman课程中验证的Nginx镜像与本地内容,仅监听127.0.0.1:18028。本例通过用户服务管理,应区分systemctl --user与管理系统服务的sudo systemctl。

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

rootless 的值应为 true,cgroups 应为 v2。如果存在同名的服务、容器或材料,不要用新的设置覆盖它们,而应先进行检查。该虚拟机现有的 linger 为 no,为了实践,仅为该用户将其改为 yes,并在结束时恢复。

根据已安装的版本确认支持的选项。 Podman 5.8 系列 Quadlet 文档 说明了用户搜索路径、创建方法以及各设置的对应关系。不要假设最新文档中的新选项在之前发行版的软件包中也受支持。

在检查了该账户管理的用户服务后,仅为相应用户设置 linger。这不是针对单个容器的选项,而是影响该账户的用户管理器的生命周期。之前设置为 yes 的账户在操作结束后不会随意更改为 no。

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

loginctl 手册 解释了 linger 是一个在启动时启动用户管理器并在注销后保持其活动的功能。

文档路径及完整 Quadlet 文件的准备

以下操作在普通用户的 shell 中执行。数据目录 lf-course28 是新创建的,重用了第 27 课中记录的镜像引用。如果第 27 课没有完成,则需要先下载官方镜像并检查源和摘要以准备相同的引用文件。

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"

将以下完整内容保存到 ~/.config/containers/systemd/lf-course28.container 中。此处的主目录路径为实际练习用户的路径。如果使用其他账户执行,请修改卷的源路径以匹配该账户,并用你已确认的值指定镜像引用。

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
章节 · 设置 在此服务中的角色
[Container] 这些是 Podman 的执行要求,例如镜像、名称、端口和挂载。
Pull=never 它使用已经检查过的本地保存镜像。如果镜像不在缓存中,启动将失败,因此需要提前准备。
Volume=…:ro,Z 提供新的专用文档,以只读模式,并为容器应用适当的 SELinux 上下文。
Restart=on-failure 在服务异常终止时重新启动。这与明确停止区分开。
WantedBy=default.target 将该服务链接到用户管理器的默认启动目标。

由于这不是一个自动跟踪镜像临时标签的配置,更新需要检查新的摘要、更改文件,然后再次进行验证。仅使用新的专用路径进行挂载,不要挂载或重新标记整个主目录。

服务创建、执行以及实际的 HTTP 验证。

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

实际创建的服务在 /run/user/1000/systemd/generator/lf-course28.service 中,其状态为 generated。创建的文件包含容器执行命令以及停止/清理命令。不要直接编辑此文件;请修改原始 .container 文件,并通过运行 daemon-reload 来重新创建它。

该服务处于活动/运行状态并返回了 LF28 Quadlet service works。创建的服务的默认类型为 notify,容器监控程序 conmon 发出其启动信号,但仅凭这一点不足以判断 Web 应用是否正确响应。实际的 HTTP 响应和预期内容会单独进行检查。启动后立即观察到一次连接重置,因此使用了有限的重试次数。

并未像处理普通文件一样将 systemctl --user enable lf-course28.service 应用于创建的服务。Quadlet 生成器处理来自原始文件的 [Install] 设置。需要单独检查用户管理器在启动时自身启动的条件。

将异常终止与显式停止进行比较。

测试仅针对本教程中创建的容器。在启动之前记录容器 ID 和重启次数,并使用 SIGKILL 信号(强制终止)来重现异常终止。相同的命令不会直接应用于生产服务。

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/

在原实验中,容器 ID 从 01951ad831a1… 变为 610769498aeb…,服务计数器变为 NRestarts=1,并且单独的 HTTP 请求返回预期内容。停止后立即查询可能会失败,因为系统正在等待重启或容器替换,因此请将结果与服务日志和稳定后的状态一起进行比较。此设置不仅保留同一容器中的进程,还允许在生成的执行条件下创建新容器。

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

在明确停止后,它处于非活动状态,并且容器存在检查返回退出码 1。即使在 3 秒后,它也没有自动重新创建,手动启动后才再次响应。在服务运行期间,管理是基于 systemd 的策略和状态,而不是重复地对 Podman 应用单独的重启策略。 systemd.service 文档 解释了重启条件和手动停止的行为。

验证注销后持续运行与开机后登录前启动

启动服务,结束 SSH 会话,然后重新连接而无需再次发出启动命令。在原实验中,HTTP 在 02:32:48 时仍然正常工作,而服务启动时间仍为 02:30:56。比较启动时间有助于区分服务的持续存在与下次登录时新启动的服务。

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

重启将断开 SSH 连接。仅在可以访问控制台的专用练习虚拟机上执行此操作,重新连接后先查询新的启动ID和服务状态,不要先手动启动服务,否则无法判断它是否已自动启动。以下命令用于查询以比较服务是否在首次登录之前启动。

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

在原验证中,启动 ID 已更改,且服务处于活动/运行状态。自该次启动以来以微秒为单位测量的服务激活时间戳为 319329250 微秒,第一次 SSH 会话的开始时间为 361617018 微秒。在同一次启动内比较显示,服务在登录前约 42 秒启动。文档和 Quadlet 文件的哈希值相同,并且 HTTP 内容保持不变。

此虚拟机的重启总共耗时约5分钟22秒,包括内核阶段大约4分钟57秒,并且cbc-aes-aesni自检留下了rc=-110警告。在启动延迟期间的第一次SSH尝试失败,并在确认控制台响应并确保系统已准备好连接后进行了验证。已确认Quadlet自动启动,但此结果不应被解读为环境通过了加密自检。不要将启动延迟的原因与服务自动启动设置混淆。

未创建的服务与启动失败的服务之间的区别

Unit not found 容器执行之前,创建可能失败。首先,检查文件扩展名 .container、用户搜索路径、部分名称以及已安装版本支持的键。如果文件已创建但执行失败,请检查镜像缓存、挂载源、端口和应用日志。

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

原实验将不正确的 NotARealKey 放置在实际搜索路径之外的单独测试文件夹中,并且仅执行了生成器的干运行。生成器返回退出代码为 1 和 unsupported key,且未创建执行命令。仅限于正常源的干运行退出代码为 0,并且服务在执行期间保持活动状态。您可以在单独路径中诊断语法,而无需故意破坏操作文件。

在更改原始设置后,daemon-reload 的任务是重新读取服务定义。要使用新设置重新创建已经运行的容器,您需要执行 systemctl --user restart lf-course28.service,同时考虑必要的停机时间并重新检查状态、实际响应和数据。任何错误的修改都应恢复到存储的原始状态,并按照相同顺序重新验证。

禁用自动启动并清理实践。

在移除实践设置时,首先停止用户服务。在将原始 Quadlet 移出搜索路径并执行 daemon-reload 之后,生成的文件和启动目标连接也会被清理。如果这是一个将继续运行的服务,请不要执行此清理命令。

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' 

原清理结果是 LoadState=not-found,容器存在性检查退出代码为 1,端口18028的监听查询为空。文档保持完整,已完成使用的专用路径的 SELinux 上下文已恢复为普通主目录文件上下文。只有在操作前不存在的空配置目录被移除,原有的用户设置得以保留。

只有原linger值为no、确实由本次练习改为yes,而且该账户没有其他需要长期运行的用户服务时,才执行下面的恢复。原值为yes的账户应保持yes。

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

原实验的linger设置最初为no,并且仅适用于此练习账户,在此账户中不需要其他长时间运行的用户服务。在原实验清理后,它被恢复为否,并保留了现有的 SSH、防火墙、Nginx、hosts文件、fstab、用户 ID 映射和 SELinux 本地设置。服务定义和资料仍保存在专用记录目录中,以便恢复和查看。