Debian 13 講座 / Quadletとlingerで起動・再起動を管理する
Debian 13でユーザーサービスとしてルート権限なしコンテナを操作するには、元のQuadletを作成し、systemdのユーザーマネージャーが生成したサービスを管理します。異常終了時の再起動、明示的な停止、ログアウト後の持続、起動時の自動開始は異なる条件であるため、それぞれ別々に確認する必要があります。このチュートリアルでは、専用のWebコンテナとボリュームを作成し、lingerの元の値を保持してから、HTTPレスポンスを確認します。
Quadletのソースファイルと生成されたサービスを区別する
Quadletは、.containerなどの拡張子を持つファイルを読み取ってsystemdサービスを生成するPodmanの機能です。通常のユーザーは、ソースを~/.config/containers/systemdに配置し、systemctl --userで管理します。/run/user/UID/systemd/generator配下の生成された.serviceファイルを直接修正すると、再生成時に消えてしまうため、元のファイルを修正する必要があります。
このチュートリアルは、Podman 5.4.2、cgroup v2、systemdユーザーマネージャー環境で実行されました。Podman 5.4.2のQuadletドキュメントによると、 サポートされているキーとしてImage、ContainerName、PublishPort、Volume、Pullを使用します。新しいドキュメントから直接キーを使用するとサービスが生成されない問題を避けるために、まずインストールされているバージョンとジェネレーター出力を確認してください。
生成されたサービスは、通常の恒久的なサービスファイルのように systemctl enable で管理されるものではありません。元のファイルの [Install] セクションに WantedBy=default.target を入れると、ジェネレーターはユーザーのデフォルトターゲットへのリンクを作成します。rootless の元のファイルに User= を追加してアカウントを切り替えようとしないでください。実際の通常ユーザーとして作業してください。
ユーザーセッション、イメージ、および専用ボリュームを準備する
前のレッスンで確認した通常のユーザー Podman 環境を使用します。パッケージのインストールは sudo で行い、次の podman および systemctl --user コマンドは通常ユーザーとして実行します。ポート 8080 と名前 lf-web28 が使用可能である必要があります。この例では、前のレッスンのボリュームとは異なる lf-web28-data を使用します。
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
新しい Bash ターミナルで、次の準備ブロックを実行します。Linger はアカウントのユーザーマネージャ全体に適用されるため、他のユーザーサービスが存在するアカウントで使用する前にメンテナンス範囲を考慮してください。元の値の別の記録を保持して、クリーンアップ中に元は yes だったアカウントを no に変更しないようにします。
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"
この演習では、事前にイメージを取得し、ダイジェストを使用します。サービスの Pull=never は起動時にダウンロードを試みないようにするため、イメージがローカルにない場合、起動は失敗します。イメージが削除されても自動的に回復するとは限らないため、イメージの保持および更新の手順を一緒に確立してください。公式 httpd イメージのウェブルートは、httpd イメージガイド で確認できます。
Quadlet全体を記述し、生成結果を確認する
以下の設定全体を同じターミナルに保存します。heredoc の CONF が引用符で囲まれていないため、以前に定義した $image は実際のダイジェストに展開されます。このファイルはそのユーザーの設定ファイルです。
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
| 設定 | 意味 |
|---|---|
| PublishPort=127.0.0.1:8080:80 | ポートを VM のループバックのみに公開します。 |
| Volume=...:ro | ウェブデータボリュームを読み取り専用でマウントします。 |
| Restart=on-failure | 失敗により終了したサービスを systemd に再起動させるよう要求します。 |
| RestartSec=2 | 再起動間の待機時間。これは繰り返しの失敗に対する制限を解除するものではありません。 |
| TimeoutStartSec=180 | サービスが起動するまでの待機時間を設定します。これはHTTPの準備完了状態をチェックするものではありません。 |
| WantedBy=default.target | ジェネレーターはユーザーマネージャのデフォルトターゲットから起動するように接続します。 |
新しい原本を読み込ませる前に、検索対象を実習用ディレクトリに限定して生成結果を確認し、daemon-reloadを実行してください。--dryrunは生成された内容を表示する機能であり、コンテナを起動するものではありません。
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
このVMでは、SourcePathはホームディレクトリ内のlf-web28.containerで、FragmentPathは/run/user/1000/systemd/generator/lf-web28.serviceでした。生成されたファイルにはPodmanの実行/クリーンアップコマンドとイメージダイジェストが含まれていました。サービスが存在しない場合は、ソースパス、ファイル拡張子、サポートされているキー、およびジェネレーターエラーを確認し、生成されたファイルを手動で作成して上書きしないでください。
lingerを有効にしてサービスとHTTPを確認する
lingerを有効にすると、このアカウントのユーザーマネージャが起動時に開始され、ログアウト後も使用可能になります。Debianのloginctlマニュアル が説明しているように、これは単一のサービスだけでなくユーザーマネージャに影響します。記録されたラボでは、lingerは最初はnoで、検証のためだけにyesに変更されました。
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
期待される応答は LF QUADLET 28 です。「active」は生成されたサービスが稼働中であることを意味し、HTTP が準備完了であることと同じではありません。検証時、起動直後のリクエストはEmpty reply from server(サーバーからの空の応答)で失敗しましたが、準備完了後には成功しました。すべての失敗を準備遅延のせいにしないでください。少し後に再度リクエストを試み、それでも失敗が続く場合は、以下のログおよびポートとボリュームの状態を確認してください。
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
明示的な停止と失敗時の再起動を比較する
以下の比較は、静的ファイルのみを提供する専用の練習用コンテナに限定されます。データベースなどの実際の書き込みサービスに対して、強制終了テストをそのまま適用しないでください。まず、コンテナIDと再起動回数を記録し、次にKILL信号を送信して障害終了を発生させます。
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/
検証では、NRestartsが増加し、コンテナIDが変更され、HTTPレスポンスが再び成功しました。3秒はチェックを開始するための例であり、すべての環境での復旧時間を保証するものではありません。繰り返しの障害が上限に達した場合は、ジャーナルで見つかった原因を修正し、reset-failedを行った後、影響を受けたサービスのみを再起動してください。再起動回数は管理者による再起動でリセット可能であり、長期的な障害統計にはそのまま使用されません。
次に、systemdで明示的に停止を要求します。Restart=on-failure が設定されていても、管理者が停止要求を行った後にサービスが自動的に再起動されることを意味するわけではありません。ポリシーの条件は 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/
停止後、結果は inactive で、専用コンテナも削除されました。アクティブのままの場合、例はエラーで停止し、正常に停止した場合は再起動前に ActiveState=inactive を確認します。起動直後に応答が準備できていない場合は、前のセクションで説明したようにステータスとログを確認し、リクエストを再試行してください。ボリュームはコンテナ削除とは独立して残ります。
ログイン前の起動とログアウト後の継続を検証する
再起動後、同じユーザーでSSH接続を行い、サービスがアクティブであることだけでは、ログイン前に自動起動が行われていることの証明にはなりません。これは、ユーザー管理のサービスがログインプロセス中に開始される可能性があるためです。このチュートリアルでは、ユーザーサービスに依存せず、ログインセッションが存在しない時間に応答とセッションリストを記録するため、root権限でHTTP GETを行う観測用プローブをスケジュールしました。
同じ方法で確認するには、下記の専用パスがすべて存在しないことを確認した後、ルート管理プローブを準備できます。これは他のサーバー上の既存のタイマーやログを変更することはありません。コードがルートとして実行される場合でも、HTTP GETおよびセッションクエリを実行し、自身のルート専用の証跡ログを書き込むだけで、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
まず、ログアウト後も維持されるかをテストします。下記のスケジューリングが成功した場合、対象ユーザーのすべてのインタラクティブセッションからログアウトし、少なくとも70秒待ってから再度ログインして記録されたデータを確認します。スケジューリング直後にセッションを開いたままにしておくことは、ログアウトの検証にはなりません。同じ名前の一時ユニットが残っている場合は、既存の状態を確認し、重複実行を避けてください。
sudo systemd-run --unit=lf-logout28-probe --on-active=15s --timer-property=AccuracySec=1s /usr/local/sbin/lf-boot28-probe logout
プローブはリトライループの前にセッションリストを記録するため、プローブがまだリトライ中にログインした場合、そのリストだけでは不十分です。再接続後、sudo journalctl -b -u lf-logout28-probe.service --no-pagerを確認し、成功したジョブ完了時間をloginctl session-statusに表示されるログイン時間と比較してください。再起動後はlf-boot28-probe.serviceに相当するジャーナルクエリを使用してください。プローブがターゲットユーザーのログイン前に成功して終了した場合にのみ証拠を受け入れてください。UTCファイルのタイムスタンプとジャーナル/セッション時間を比較する際は、タイムゾーンのオフセットを考慮してください。70秒/90秒の待機時間は、通常の負荷下におけるプローブの制限付きリトライを許容するものであり、経過時間だけでは証拠にはなりません。
再度ログインした後、次のコマンドを使用してプローブの時間、セッションリスト、および HTTP_PROBE_PASSED を確認してください。class=managerのユーザーマネージャー用セッションと、class=userの実際のログインセッションを区別してください。プローブ実行時に対象アカウントの別のログインセッションが残っていた場合、全ログアウト後もサービスが継続した証拠にはなりません。
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
コンソールアクセスと他の稼働中サービスへの影響を確認した後、VM を通常通り再起動する手順は以下の通りです。開始前にブートIDを書き留め、再起動後はそのユーザーを少なくとも 90 秒間ログアウト状態にしてください。タイマーが終了する前にアクセスすると結果が混乱するため、記録された時間と実際のログイン時間も比較してください。
cat /proc/sys/kernel/random/boot_id
sudo systemctl reboot
再度ログインした後、新しいブートIDが前回のものと異なるかを確認し、そのブートの記録を読み取ります。ログがない場合や失敗した場合は、自動起動の成功とはみなされません。
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/
検証用VMでは、マネージャーセッションのみが存在し、状態がlingeringの場合に、新しいブート後約46秒でHTTPが成功しました。実際のユーザーセッションがない場合の別のログアウトテストも成功しました。デフォルトのタイマー精度でスケジュールされた初期プローブは、検証用の再ログインと重複したため証拠として使用されず、AccuracySec=1sを指定して再確認されました。基準は、実行時間の正確さではなく、ログイン前に結果が維持されているかどうかです。
原本とボリュームを削除し、lingerを元に戻す
停止すると現在の実行は中断されますが、[Install]付きの元のものが残っている場合、次回のユーザーマネージャー起動時に再び起動する可能性があります。練習用セットアップを削除するには、対応する元のファイルを削除し、生成されたリンクをクリーンアップするためにdaemon-reloadを実行してください。以下の最初のブロックは通常ユーザーとして実行する必要があります。
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
ボリュームを削除するとデータも削除されるため、まず必要な内容を保存してください。その後、練習用システムのタイマーとスクリプトのみを削除してください。証拠記録はルート専用のバックアップパスに残しておくことができます。
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
実際のクリーンアップでは、専用のQuadlet原本、生成されたサービス、コンテナ、ボリューム、およびプローブが削除され、8080リスナーは閉じられ、lingerは元の「no」の設定に戻されました。既存のイメージやその他のサービスは保持されました。通常のユーザーサービスを引き続き実行するかどうかを判断する際には、アカウントの有効期間、データ保持、更新および復元手順を一緒に管理してください。




