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 Enforcingを使用しました。 rootless Podman講座で確認した公式Nginxイメージ とローカルコンテンツを再利用し、公開先を 127.0.0.1:18028 だけに限定します。このQuadletはユーザーサービスとして実行します。システムサービスを管理する 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であることを確認してください。同じ名前の既存のサービス、コンテナ、またはマテリアルがある場合は、新しい設定で上書きせず、まずそれらを確認してください。この VM の既存の 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を準備する
以下は通常のユーザーシェルで実行されます。データディレクトリ 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 がその開始を通知しますが、これだけではウェブアプリケーションが正しく応答するかどうかを判断するには不十分と見なされます。実際の 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秒経っても自動的に再作成されず、手動で起動すると再度応答しました。サービス運用中は、Podman に別の再起動ポリシーを重複して適用するのではなく、systemd のポリシーとステータスに基づいて管理されます。 systemd.service ドキュメント では、再起動条件や手動停止の挙動について説明しています。
ログアウト後およびログイン前の起動時に永続性を確認する
サービスを開始し、SSHセッションを終了して、別のstartコマンドを発行せずに再接続します。元の検証環境では、サービスの開始時間が02:30:56のままで、HTTPは02:32:48の時点でも動作していました。開始時間を比較することで、次のログインによって新たに開始されたサービスと持続しているサービスを区別するのに役立ちます。
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接続は切断されます。コンソールアクセスが可能な専用の練習用VM上でのみ実行し、再接続後は手動でサービスを起動せず、新しいブート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ボディは保持されていました。
このVMの再起動には合計で約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コンテキストは一般的なホームファイルコンテキストに戻されました。実践前に存在しなかった空の設定ディレクトリのみが削除され、既存のユーザー設定は維持されました。
sudo loginctl disable-linger "$(id -un)"
loginctl show-user "$(id -un)" -p Linger
上記のlingerの解除は元々「いいえ」に設定されており、他の長時間実行するユーザーサービスが不要なこの練習用アカウントのみに適用されます。元の検証環境でのクリーンアップ後、「いいえ」に復元され、既存のSSH、ファイアウォール、Nginx、hostsファイル、fstab、ユーザーIDマッピング、SELinuxのローカル設定は保持されました。サービス定義および関連資料は、復元および確認のため専用の記録ディレクトリに残されています。




