Debian 13 講座 / Rootless Podmanと永続ボリュームを使う
Debian 13 では、通常のユーザーとして Podman を実行し、ルート権限不要のコンテナを作成することができます。コンテナを交換した後も必要なファイルを保持するには、一時的な書き込みレイヤーとは別のボリュームに保存し、同じユーザーと同じボリュームで再実行する必要があります。このチュートリアルでは、公式の httpd イメージをダイジェストで固定し、ループバックポートでのレスポンスとデータ保持を検証します。
イメージ、コンテナ、名前付きボリュームを分離する
イメージは、プログラムおよび実行に必要なファイルを含む配布単位であり、コンテナはそのイメージから作成された実行中のインスタンスです。コンテナの書き込み可能レイヤーに書き込まれたファイルは、別途マウントされたストレージの外では、そのコンテナが削除されると失われます。名前付きボリュームは、別の名前で管理されるストレージスペースで、コンテナと保存データのライフサイクルの分離を可能にします。
ルートレスとは、ホスト上で通常のユーザー権限で実行することを意味します。コンテナ内のUID(User ID:ユーザーID)0は、ホスト上のrootと同じようには扱われません。ルートレスコンテナでも、ホストユーザーが利用できるリソースを利用でき、ホストカーネルを共有します。その隔離は、別のVMと同等ではありません。基本的な実行構造は、Podman 5.4.2 ドキュメント を参照できます。
| 対象 | 実習名 | 置換時の取り扱い |
|---|---|---|
| イメージ | docker.io/library/httpdのダイジェスト | 同じ内容で再実行できるよう、識別値を記録する。 |
| コンテナ | lf-web27 | 停止して削除し、新しいものを作成する。 |
| 名前付きボリューム | lf-web27-data | コンテナ置換時に保持し、新しいコンテナに接続する。 |
| 外部ポート | 127.0.0.1:8080 | Debian VM 内でのみアクセス可能であり、実行後に再度確認してください。 |
パッケージと一般ユーザーセッションを確認する
sudoを使用でき、イメージレジストリへ接続できる専用のDebian 13 VM が必要です。インストールは必ず sudo で行い、その後はすべての podman コマンドをログインした通常ユーザーとして実行してください。sudo podman に切り替えないでください。root用の別のイメージ・コンテナ保存領域にアクセスするため、トラブルシューティングでも混在させないでください。
sudo apt update
sudo apt install podman uidmap passt fuse-overlayfs curl
podman --version
id
printf '%s\n' "$XDG_RUNTIME_DIR"
grep "^$(id -un):" /etc/subuid /etc/subgid
systemctl --user is-system-running
podman info --format json
演習では、Podman 5.4.2、UIDおよびGID(Group ID:グループID)が1000 の通常ユーザー、および実行パス /run/user/1000 を使用しました。/etc/subuid と /etc/subgid にはそれぞれ lfstudent:100000:65536 が含まれており、ユーザーマネージャーが実行中でした。この範囲は、追加のコンテナユーザーIDをマッピングする際に使用されます。他のアカウントから範囲をコピーして重複を割り当てないでください。
podman info は host.security.rootless が true、cgroupVersion が v2、cgroupManager が systemd、ユーザーのホームディレクトリ下で overlay を使用したストレージを示しました。環境変数やユーザーマネージャーの接続エラーがある場合は、通常ユーザーの実際の SSH またはコンソールログインセッションから再度確認してください。XDG_RUNTIME_DIR を任意のパスで偽装したり、sudo 環境を混在させて正常に見せかけたりしないでください。
実習用の名前のいずれか、またはポート8080が既に使用されている場合は、既存のリソースを削除せずに、実習名とポートを変更する計画を立ててください。ラボには専用のBashセッションを1つ使用します。準備ブロックはエラー停止を有効にします。予期しない失敗でシェルが終了した場合は、続行する前に新しい一般ユーザーセッションから残りのリソースを確認してください。
set -euo pipefail
if podman container exists lf-web27; then
echo "A container with this name already exists." >&2
exit 1
fi
if podman volume exists lf-web27-data; then
echo "A volume with this name already exists." >&2
exit 1
fi
if test -e "$HOME/lf-course27-image.txt"; then
echo "The image record file already exists." >&2
exit 1
fi
ss -ltn
公式イメージを選択し、そのダイジェストを記録する
短いhttpd名の代わりに、レジストリとネームスペースを含むアドレスを使用します。httpd Docker公式イメージガイド はタグ、Dockerfile、Webルートパスを確認および選択するために使用されました。これはApache HTTPサーバー用のDocker公式イメージであり、コンテナ内でホストのNginxとは異なるプログラムを実行します。
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 "Unexpected image reference." >&2; exit 1 ;;
esac
printf '%s\n' "$image" | tee "$HOME/lf-course27-image.txt"
podman image inspect "$image" --format '{{.Architecture}} {{.Os}} {{.Id}}'
検証中に記録された参照は以下の通りです。実際の実行では、上記のinspectで取得した値を使用し、タグが変更された場合は新しいダイジェストが表示されることがあります。アーキテクチャはamd64で、オペレーティングシステムはlinuxでした。
docker.io/library/httpd@sha256:32e9403360ab2f1047523e72f256527fb9aee68b342abf6ad03f0d629157f3d9
タグは他のイメージに移動することがありますが、ダイジェストはコンテンツを識別するために使用されます。ダイジェストを記録することは、自動的に誰がイメージを作成したかを解決したり、脆弱性に対応したりすることにはなりません。固定されたイメージは、最新のセキュリティパッチに自動で更新されるわけではないため、新しいバージョンの確認、テスト、置換のスケジュールは別途管理されます。プルに失敗した場合は、レジストリ認証、リクエスト制限、DNS、TLS、およびネットワークエラーを区別し、同名の任意のイメージを実行しないでください。
専用ボリュームを作成し、ループバックポートを公開する
まず、名前付きボリュームを作成し、一時的なコンテナで index.html を記録します。準備用コンテナはネットワークを必要としないため、none で実行され、終了後に --rm で削除されます。ボリューム自体はそのまま残ります。このボリュームは新しい練習用であるため、既存サービスのウェブルートを上書きしません。
podman volume create lf-web27-data
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "LF PODMAN 27\n" > /data/index.html'
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
podman ps
podman port lf-web27
curl --noproxy '*' -fsS http://127.0.0.1:8080/
-p の左側はホストのアドレスとポートで、右側の 80 はコンテナ内のポートです。127.0.0.1 を指定すると、VM 内でのみアクセス可能になります。-v の最後の :ro は、このウェブサーバーにボリュームを読み取り専用としてマウントすることを意味します。これは、他のコンテナやホストプロセスがボリュームに書き込むのを防ぐグローバルな設定ではないため、この段階は準備用のコンテナが書き込む段階とは区別されます。
実際のポート出力は 80/tcp → 127.0.0.1:8080 で、応答は LF PODMAN 27 でした。起動直後の場合は、少し待ってから再度リクエストしてください。それでも失敗する場合は、podman logs lf-web27 および podman inspect lf-web27 でポートの競合を確認してください。コンテナが実行中であることは、HTTP応答が成功したことを意味するわけではありません。
コンテナを交換してデータの永続性を確認する
以下の手順では、ボリュームファイルのハッシュを保存し、コンテナの /tmp に比較ファイルを作成します。Inspect はボリュームパスを読み取るために使用されますが、Podman ストレージ内の他のディレクトリは直接変更されません。コンテナを停止して削除した後、ボリューム内のファイルが同じままであるかどうかを確認してください。
point=$(podman volume inspect lf-web27-data --format '{{.Mountpoint}}')
hash_before=$(sha256sum "$point/index.html")
podman exec lf-web27 sh -c 'printf "ephemeral\n" > /tmp/lf-web27-marker'
podman stop lf-web27
podman rm lf-web27
test -f "$point/index.html"
test "$hash_before" = "$(sha256sum "$point/index.html")"
podman run -d --name lf-web27 -p 127.0.0.1:8080:80 -v lf-web27-data:/usr/local/apache2/htdocs:ro "$image"
curl --noproxy '*' -fsS http://127.0.0.1:8080/
podman exec lf-web27 test ! -e /tmp/lf-web27-marker
検証において、新しいコンテナのHTTPレスポンスは同じであり、index.htmlのハッシュも同一でした。一方で、前のコンテナの/tmpファイルは新しいコンテナには存在しませんでした。最後のテストは成功した場合は何も出力せず、終了コード0を返します。これらの結果から、ボリュームとコンテナの書き込み可能レイヤーの寿命の違いを区別することができます。
新しいコンテナの起動が遅く、curlが失敗した場合は、実際の状態とログを確認し、リクエストを再試行してください。エラーで停止するシェルでは、後でクリーンアップが行われたと仮定しないでください。podman ps -aやpodman volume lsで残っているリソースを確認してください。ボリュームの保持はバックアップとは異なります。ユーザーホームやホストディスクを失うと、同じローカルボリュームも失われる可能性があります。
実行中のコンテナの実際の AppArmor 状態を確認する
ホストで AppArmor が有効になっていても、すべての rootless コンテナが強制適用されるプロファイルで制限されていると仮定すべきではありません。置き換えられたコンテナが現在実行中の場合、以下のコマンドを使用してインスペクト情報と実際のプロセス状態を比較します。
podman info --format json
podman inspect lf-web27 --format '{{.AppArmorProfile}}'
podman exec lf-web27 cat /proc/self/attr/current
このチュートリアルでは、最初のコンテナが実行中のときに確認しました。ホストの AppArmor モジュールは Y でしたが、rootless の情報の apparmorEnabled は false で、コンテナの AppArmorProfile は空であり、プロセスの出力は crun (unconfined) でした。これらの結果を、このコンテナに enforce モードの AppArmor プロファイルが適用されていると解釈してはいけません。AppArmor や seccomp を無効化したわけでもなく、エラーを避けるために --privileged を追加したわけでもありません。
ホストとコンテナのUIDマッピングを比較する
ルートレスコンテナのユーザー名ではなく数値IDのマッピングを確認します。この演習のデフォルトの名前空間では、コンテナのUID 0 はホストの1000に対応し、UID 1から65536はホストの100000以降に対応していました。グループも同様の構造になっています。別のアカウントや --usernsオプションを使用すると異なる場合があります。
podman unshare cat /proc/self/uid_map /proc/self/gid_map
stat -c '%u:%g' "$point/index.html"
podman unshare stat -c '%u:%g' "$point/index.html"
index.htmlはホストでは1000:1000として表示され、podman unshare内では0:0として表示されました。UnshareはPodmanのユーザー名前空間内で異なるIDの視点から同じファイルを見るためのツールであり、ホスト全体のルート権限を得るコマンドではありません。podman unshareマニュアル はこの名前空間の範囲について説明しています。
追加の比較のために、サーバーを停止した後、同じ実習用ボリュームに単一のファイルを作成し、それをコンテナのUID/GID 33に設定します。この数値はマッピングを観察するためのものであり、すべてのイメージが同じサービスアカウントを使用することを意味するわけではありません。
podman stop lf-web27
podman rm lf-web27
podman run --rm --network none -v lf-web27-data:/data --entrypoint /bin/sh "$image" -c 'printf "mapped\n" > /data/mapped.txt; chown 33:33 /data/mapped.txt'
stat -c '%u:%g' "$point/mapped.txt"
podman unshare stat -c '%u:%g' "$point/mapped.txt"
実際の結果はホスト 100032:100032、ネームスペース 33:33 でした。これはホスト上でファイルの所有者を33に変更することとは同じではありません。権限の問題を解決するために、ユーザーホーム全体に対してchownを適用することはありません。:Uオプションはホスト側で所有権を再帰的に変更できますし、:zおよび:ZはSELinuxラベルに関連しているため、AppArmorの問題に対する一般的な解決策としては付加されません。ボリュームオプションの正確な効果は、Podman runのボリュームおよびセキュリティオプション で確認できます。
ラボのボリュームのみを削除し、イメージ記録は保持する
上記のマッピング比較を最後まで実行した場合は、lf-web27を停止・削除済みです。ボリュームを削除する前に podman ps -a でこれを確認してください。比較をスキップし、ラボコンテナがまだ存在する場合は、podman stop lf-web27 で停止し、podman rm lf-web27 で削除してください。使用中のボリュームを無理に削除しないでください。
この演習で残っている専用ボリュームを削除すると、それに含まれるデータも削除されます。まず、保存する必要があるファイルがあるかどうかを確認してから、特定の名前のみを削除してください。名前付きボリュームの作成および管理の範囲は Podman volume create ドキュメント で確認できます。
podman ps -a
podman volume inspect lf-web27-data
podman volume rm lf-web27-data
podman volume ls
ss -ltn
実際のクリーンアップでは、lf-web27 コンテナと lf-web27-data ボリュームのみが削除されました。受け取ったイメージや lf-course27-image.txt のダイジェスト記録は保持され、他のイメージやボリュームを一括で削除する prune は使用されませんでした。永続データとイメージ再現情報を別々に保持するかどうかを決定することで、演習のクリーンアップと運用データの削除を混同することを避けることができます。




