Rocky Linux 10 講座 / rootless Podmanでコンテナを実行し、データとUIDマッピングを確認する
Rocky Linux 10 で rootless Podman を使用すると、通常ユーザー権限でコンテナを実行できます。ただし、コンテナを置き換える際にデータを安全に維持するには、ポート公開範囲、ホストに保存されているデータ、ユーザー ID マッピング、および SELinux コンテキストを個別に確認する必要があります。
通常ユーザー環境でrootless状態を確認する
コンテナは、アプリケーションのプロセス、ファイルシステム、およびネットワークを分離して実行しつつ、ホストカーネルを共有します。Rootlessとは、ホスト上でルート権限なしで実行することを意味します。コンテナ内でルートとして見えても、ホストのルートユーザーと同じではありません。
元の講座の検証環境は Rocky Linux 10.2、Podman 5.8.2、crun 1.30.1、SELinux Enforcing で、通常のユーザー lfstudent のユーザーID とグループID (UID·GID) は1000です。管理者はパッケージをインストールしますが、その後 podman のコマンドは通常ユーザーのログインシェルで実行されます。sudo podman に切り替えると、ルートが所有する別のイメージストアとコンテナが表示されるため、同じコンテナを扱うつもりで混在させないでください。
sudo dnf install podman
id
podman version
podman info --format '{{.Host.Security.Rootless}}'
podman info --format '{{.Store.GraphRoot}}'
grep "^$(id -un):" /etc/subuid /etc/subgid
podman unshare cat /proc/self/uid_map /proc/self/gid_map
rootlessクエリはtrueを返すべきであり、このユーザーのイメージストレージは/home/lfstudent/.local/share/containers/storageでした。従属IDの設定は、コンテナ内の追加UID・GIDをホスト側の専用ID範囲に対応付けるために使われます。このVMでは、lfstudent:524288:65536はすでに登録されているため、変更されませんでした。存在しない場合や他のユーザーの範囲と重複する場合、管理者は全体の割り当てを確認し、設定する必要があります。例の番号をそのまま追加しないでください。
Rocky Linux rootless Podman のドキュメント では、ユーザーマッピング、ローカルストレージ、およびログインセッションの条件について説明されています。元の演習では、ローカルXFSストレージが使用され、cgroups v2(control groups version 2)でプロセスリソースが管理されていました。共有ホームディレクトリやその他のセッション設定が同じ環境であると仮定しないでください。
イメージの提供元と実際のダイジェストを記録する
イメージは、コンテナを作成するために使用されるプログラムと初期ファイルをまとめたパッケージであり、レジストリはイメージを配布します。この例では、Docker Hub の docker.io/library/nginx イメージを使用し、 公式 NGINX Dockerfile リポジトリ を通じて管理されています。レジストリやリポジトリを省略した短い名前ではなく、完全修飾イメージ名を使用してください。
LAB27="$HOME/lf-course27"
test ! -e "$LAB27" || { printf 'Inspect the existing lab directory and stop.\n' >&2; exit 1; }
podman ps -a
podman images
mkdir -m 0755 "$LAB27"
podman pull docker.io/library/nginx:stable-alpine
podman image inspect docker.io/library/nginx:stable-alpine --format '{{.Id}} {{.Digest}} {{.RepoDigests}} {{.Architecture}}'
podman image inspect docker.io/library/nginx:stable-alpine --format '{{index .RepoDigests 0}}' > "$LAB27/image.ref"
IMAGE27=$(cat "$LAB27/image.ref")
同じ作業ディレクトリまたは lf-course27-web コンテナがすでに存在する場合は、停止して既存の状態を確認してください。test はパスが存在しない場合には終了コード 0 を返し、存在する場合には 1 を返し、通常時には別途メッセージを出力しません。その後のコマンドは同じ通常ユーザーシェルで実行され、新たにログインした場合は LAB27 および IMAGE27 が記録ファイルからリセットされます。
stable-alpine は、その内容が変わる可能性のあるタグです。この amd64 イメージでは、Nginx は 1.30.6 で、記録された参照は docker.io/library/nginx@sha256:583b7f2fce1cdb8da5ad5c39ebd3c33b98b87d493190e548bdee1fa8c619c311 でした。RepoDigests にはマルチアーキテクチャのインデックスとプラットフォームイメージの参照の両方が含まれる場合があり、このプラットフォームイメージのダイジェストは sha256:bb8f722b4be005fcd7827816a136ab779fd40185d85b5171be915cc7fc0575c7 でした。これらの値は異なるターゲットを指しているため、数字の違いだけで直ちに破損と判断されるわけではありません。
後続のコマンドは、記録されたイメージ参照を再利用し、ローカルイメージを使用するために --pull=never を渡します。ダイジェストを固定することは、この実行のターゲットを明確に指定する方法であり、セキュリティ更新を自動的に適用する機能ではありません。イメージを更新する場合は、新しいソース・ダイジェストとアプリケーションの動作を再度確認する必要があります。 podman pull ドキュメント では、参照フォーマットやダウンロードオプションについて説明しています。
ループバックポートと読み取り専用のドキュメントディレクトリ
ホスト上にドキュメントディレクトリを作成し、バインドマウントを使用してコンテナのドキュメントパスにリンクします。以下の 127.0.0.1:18027:80 は、VM 自身のループバックポート18027をコンテナのポート80に接続します。VMをWindowsで実行している場合でも、ここでの「ホスト」はPodmanを実行しているRocky Linux VMを指します。
ss -lnt 'sport = :18027'
mkdir -m 0755 "$LAB27/site"
printf 'LF27 persistent version A\n' > "$LAB27/site/index.html"
chmod 0644 "$LAB27/site/index.html"
podman run -d --name lf-course27-web --label lf.course=27 --pull=never -p 127.0.0.1:18027:80 -v "$LAB27/site:/usr/share/nginx/html:ro,Z" "$IMAGE27"
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18027/
podman port lf-course27-web
podman logs --tail 15 lf-course27-web
ポートが利用可能なときに実行します。予想される内容はLF27 persistent version Aで、ポートの検索は80/tcp → 127.0.0.1:18027です。起動直後の最初の接続でリセットが観察されたため、curlは限定回数だけ再試行するように設定されています。繰り返し試行が失敗した場合、ただ待つのではなく、podman ps -aとログで実際の起動状況を確認してください。
-p 18027:80でホストIPを省略すると、公開範囲が変わる可能性があります。今回はローカルテストなので、ループバックに明示的にバインドしており、ファイアウォールやVMのNATルールは追加していません。外部公開の場合は、実際の受信アドレス、ネットワーク経路、ポリシーを別途設計・検証する必要があります。ポートやマウントオプションは podman run公式ドキュメントで確認できます。
| マウントオプション | 意味と範囲 |
|---|---|
ro |
コンテナ内でマウントを読み取り専用にします。これは、ホストの所有者が元のファイルを変更することとは別です。 |
Z |
このコンテナに適した非共有SELinuxコンテキストで、元のパスに再ラベルを行います。新しく作成された専用ディレクトリでのみ使用してください。 |
z |
複数のコンテナ間で共有されるコンテキストを適用します。まず、必要な共有範囲が必要かどうかを判断してください。 |
U |
ユーザーのマッピングに従って元の所有権を再帰的に変更するオプションです。単純な読み取り専用の操作では必要なく、実際のホストファイルの所有者が変更される場合があります。 |
:Z をホームまたはシステム全体のディレクトリに適用すると、他のプログラムのファイルコンテキストも変更される可能性があるため、この例では新しい site パスへのリンクのみを行います。2つの独立したコンテナが同じパスに :Z を適用した場合、最後のコンテキスト変更が前のコンテナへのアクセスに影響を与える可能性があります。
元の比較検証において、最初のドキュメントが user_home_t 状態にある場合、:ro のみを使用すると HTTP 403 およびファイルアクセス拒否のログが発生しました。同じ素材を :ro,Z、container_file_t にリンクし、専用カテゴリを適用すると、200 が返されました。一般的な権限は 0777 に変更されず、SELinux も無効化されませんでした。
ls -Zd "$LAB27/site" "$LAB27/site/index.html"
podman exec lf-course27-web sh -c 'printf denied > /usr/share/nginx/html/blocked.txt'
printf 'LF27 persistent version B\n' > "$LAB27/site/index.html"
curl -fsS http://127.0.0.1:18027/
書き込みテストは意図的に失敗するコマンドです。Read-only file system ではゼロ以外の終了コードが期待され、blocked.txt は作成されるべきではありません。一方で、ホスト上で変更された元のファイルは即座に LF27 persistent version B として提供されました。読み取り専用マウントは、そのコンテナマウントを介した書き込みを制限します。永続的な保存を保証したり、ホスト側の変更を防ぐものではありません。
コンテナを再作成してデータの保存状態を確認する
コンテナ内の書き込み可能なファイル層とホストのバインドマウントを区別しましょう。まず、内部の一時ファイルを作成し、現在のコンテナIDとホストデータのハッシュを記録します。
podman exec lf-course27-web sh -c 'printf ephemeral > /tmp/lf27-ephemeral'
podman inspect lf-course27-web --format '{{.Id}}'
sha256sum "$LAB27/site/index.html"
podman rm -f lf-course27-web
podman run -d --name lf-course27-web --label lf.course=27 --pull=never -p 127.0.0.1:18027:80 -v "$LAB27/site:/usr/share/nginx/html:ro,Z" "$IMAGE27"
podman inspect lf-course27-web --format '{{.Id}}'
curl --retry 3 --retry-all-errors --retry-delay 1 --max-time 5 -fsS http://127.0.0.1:18027/
podman exec lf-course27-web test ! -e /tmp/lf27-ephemeral
sha256sum "$LAB27/site/index.html"
同じ名前で作成しても、コンテナIDは変更されました。ホスト文書の本文BとSHA-256 b1601d1a277b5d3b6aab1018d58594ac3cd4eab0e2195d95064a83aedd95523b は保持されましたが、コンテナ内の/tmp/lf27-ephemeral は存在しませんでした。これは、単にコンテナを停止・起動するのではなく、削除して新規作成した場合の条件下で確認されました。
バインドマウントはコンテナ外のパスを使い続けるため、コンテナを削除してもデータが削除されるわけではありません。しかし、ホストのファイルが削除されたり、ストレージデバイスが破損した場合はデータが失われるため、別途バックアップが必要です。Podmanで管理される名前付きボリュームを使用することもできますが、この講義では、上記のバインドマウント上で実際の再生成とハッシュ比較が行われました。
ユーザーIDマッピングとファイル所有権の理解
id
podman exec lf-course27-web id
podman exec lf-course27-web id nginx
podman top lf-course27-web user huser
podman unshare cat /proc/self/uid_map
コンテナのデフォルト実行ユーザーは root でしたが、podman top のホストユーザー列は 1000 でした。Nginx ワーカーのコンテナ UID 101 はホスト上では 524388 として表示されました。イメージのユーザー名がホストのユーザー名と一致する必要はありません。各名前空間の数値マッピングが実際にアクセスに影響します。
| この VM のマッピング | ホスト上で確認できる値 |
|---|---|
| コンテナ UID 0 | 通常ユーザー UID 1000 によって実行 |
| コンテナ UID 1 から 65536 | subuid 524288 から割り当て開始された範囲 |
| コンテナ UID 101 | 524288 + (101 - 1) = 524388 |
この番号は、このユーザーのデフォルトマッピングとして確認されました。実際のマッピングは--usernsなどのオプションや各ユーザーのsubuid範囲によって変わります。 podman unshare ドキュメントは その名前空間で通常ユーザーの UID と GID が 0 として表示される理由を説明しています。
以下は、新しいテストファイルに対してのみ所有権を変更し、その後元に戻す例です。Web マテリアルやホームディレクトリ全体には適用しないでください。ファイルがすでに存在する場合は、上書きせずに停止してください。
test ! -e "$LAB27/ownership.txt" || { printf 'Inspect the existing test file and stop.\n' >&2; exit 1; }
printf 'mapped uid test\n' > "$LAB27/ownership.txt"
chmod 0600 "$LAB27/ownership.txt"
podman unshare chown 101:101 "$LAB27/ownership.txt"
stat -c '%u:%g %a' "$LAB27/ownership.txt"
podman unshare stat -c '%u:%g %a' "$LAB27/ownership.txt"
cat "$LAB27/ownership.txt"
podman unshare chown 0:0 "$LAB27/ownership.txt"
stat -c '%u:%g %a' "$LAB27/ownership.txt"
rm -- "$LAB27/ownership.txt"
ホストのルックアップは 524388:524388 600 で、名前空間内のルックアップは 101:101 600 でした。この状態では、通常のユーザー cat は予想通り権限拒否エラーで失敗しました。podman unshare chown 0:0 で元に戻すと、ホストでは 1000:1000 600 になりました。この名前空間の 0 をホストの root と混同しないことが重要です。
ログアウト時の動作を確認してコンテナを片付ける
元の検証用ユーザーの設定は Linger=no でした。元の検証でSSHセッションが終了したとき、ラボでは Nginx コンテナが SIGTERM を受け取り、systemd ユーザーマネージャの終了とともに正常にシャットダウンしたことが観察されました。podman run -d はターミナルに接続せずに実行することを意味し、再起動やログアウト後にサービスの継続を保証する設定ではありません。長期実行するためには、ユーザーサービスとセッション永続性の両方の条件を一緒に設定する必要があります。
podman ps -a
podman inspect lf-course27-web --format '{{.State.Status}}'
podman logs --tail 20 lf-course27-web
loginctl show-user "$(id -un)" -p Linger
podman rm -f lf-course27-web
restorecon -RFv "$LAB27/site"
ls -Zd "$LAB27/site" "$LAB27/site/index.html"
stat -c '%u:%g %a' "$LAB27/site/index.html"
ss -lnt 'sport = :18027'
今回作成した演習用コンテナであることを確認してから、指定したコンテナだけを削除してください。コンテナがそのパスを使用しなくなったときに資料を通常のホームファイルとして保持したい場合は、コンテキストを復元できます。この環境では、ユーザーが設定可能な container_file_t が restorecon -R のみで維持され、正確な練習パスに -RF を適用した後、user_home_t に戻りました。使用中の別のコンテナのパスには適用しないでください。
クリーンアップ後、ポート18027での演習用コンテナとリスナーは消え、ホストの文書BはUID·GID 1000、モード0644のままで残っていました。既存のSSH、Nginx、ファイアウォール、hosts、およびfstabの設定、さらに元のユーザーのマッピングは保持されました。Podmanパッケージ、ポリシーサポート、およびイメージキャッシュも残っています。パッケージの変更は記録されたベースラインと比較する必要があります。既存のローカルSELinuxオーバーライドを、別のラボに合わせるためだけに削除しないでください。




