セルフホスト型アプリの更新前にコンテナのUID/GIDとボリュームの所有権を固定する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

デプロイメントで数値ユーザーの契約を固定し、コンテナの入れ替え前にボリュームの所有権を検証すれば、セルフホストアプリの更新によってroot所有のファイルが作成される可能性を抑えられます。

予防策として、イメージ内部のユーザー名を安定したストレージIDとして扱うのをやめます。永続データを書き込む実効UIDとGIDを記録し、ホストディレクトリまたは名前付きボリュームに対応付け、PUID/PGIDやユーザー名前空間の設定を維持します。さらに、全面展開の前に小さな書き込み可能パスで新しいイメージをテストします。こうすることで、イメージ更新によって設定、アップロード、データベース、メディアのメタデータの数値上の所有者が気付かないうちに変わるのを防げます。

更新前に数値のUIDとGIDを記録する

実行中のプロセスユーザー、プライマリグループ、補足グループ、および各書き込み可能なマウント内の代表的なファイルの数値による所有権を記録します。その所有権の基準値とあわせて、イメージのダイジェストまたはバージョンを保存します。

Dockerのイメージ構築ガイダンスによると、IDを明示すると再ビルドによるずれを防げます。自動割り当てされたイメージユーザーは、再ビルドのたびに異なる数値IDを割り当てられる可能性があるためです。

appやmediaなどの名前だけでなく、数値も記録します。新しいイメージで同じユーザー名が再利用されても、UIDは変わることがあり、ホスト上のファイルの所有権は数値で記録されるためです。

デプロイメントの契約で実行時ユーザーを固定する

イメージが非rootアカウントでの直接実行に対応している場合は、Composeまたは実行時設定で意図したユーザーとグループを明示します。イメージがrootでの初期化段階を必要とする場合は、その後どのプロセスが実際に永続データを書き込むのかを文書化します。

Open Containerイメージ仕様では、Userが実行時のデフォルトとして定義されているため、デプロイ時に明示的に上書きまたは検証しない限り、イメージの変更によって実行時のIDが変わる可能性があります。

サポートされている初期化モデルを必要とするイメージに、任意の非root UIDを強制しないでください。永続ファイルの所有者を予測可能に保ちつつ、アプリケーションの文書化された設計に沿って設定します。

PUIDとPGIDをホストの所有権に合わせる

PUIDとPGIDの変数を公開しているイメージでは、それらの値をバージョン管理されたComposeまたは環境設定に固定し、ホスト側のボリュームディレクトリが対応するサービスアカウントの所有になっていることを確認します。

LinuxServerによると、PUIDはコンテナからの書き込みを対応付けるため、マウントされたボリューム内で作成されたファイルをコンテナ外でも管理できます。

更新前に、設定済みのIDをホスト上のidの出力と既存ファイルの所有者情報と比較してください。サーバー上でそのIDが別の人やサービスに割り当てられている場合もあるため、1000などの例示値をそのまま使わないでください。

ユーザー名前空間とrootlessマッピングを考慮する

rootless DockerまたはPodmanでは、コンテナ内のプロセスがrootとして表示されても、ホスト上では非rootのUIDにマッピングされることがあります。所有権の変更を判断する前に、名前空間のモードとサブUID/GIDの設定を記録してください。

Podmanのランタイムオプションは、コンテナがホストにマウントされたファイルへ予測可能な形でアクセスする必要がある場合に、keep-idがユーザーマッピングを維持することを示しています。

コンテナ内でrootに見える所有者を「修正」する前に、ホスト側の数値IDを確認してください。名前空間内のrootとホストのrootは、必ずしも同じユーザーではありません。

テスト用ボリュームで新しいイメージを事前検証する

本番コンテナを置き換える前に、意図するUID/GIDを設定して、パーミッションが本番環境と同じ一時ディレクトリで新しいイメージを実行してください。起動時の初期化によってファイルとディレクトリを1つずつ作成させ、そのホスト側の所有者を確認します。

Red Hatのrootlessボリュームのデバッグガイドは、ホスト側の所有者はUIDマッピングに従うことを示しています。コンテナ内に表示されるユーザー名だけでは、十分な証拠になりません。

カナリア環境で想定外のroot所有ファイルや、IDが再マッピングされたファイルが作成された場合は、ロールアウトを停止し、イメージのユーザー、エントリーポイント、名前空間、マウント設定を比較してください。起動時の再帰的な移行によって写真やデータベースのツリー全体が変更されてから気づくより、はるかに安全です。

補助グループと書き込み可能なパスを確認する

アプリによっては、サービスのプライマリUIDに加え、共有メディア、ダウンロード、またはデバイス用グループを介したアクセスが必要です。それらのグループIDを記録し、設定ディレクトリだけでなく、書き込み可能なすべてのパスをテストしてください。

Kubernetesでは、明示的なrunAsUserおよびrunAsGroupの設定を使用します。これは、単純なDocker Composeデプロイ以外でも同じLinuxの所有権の原則が当てはまることを示しています。

新しいイメージがすべての永続パスに期待どおりのホスト側所有者でファイルを作成し、コンテナを一度再作成しても状態が維持されれば、更新ポリシーは完了です。ロールアウトによってすでにroot所有のデータが発生している場合は、関連するZimaSpaceの記事イメージ更新後にroot所有になったファイルの復旧手順を参照してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.