NAS共有用のコンテナのユーザー・グループマッピングチェックリスト

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

安全に進めるには、NASのエクスポートからホストのマウントポイント、実行中のコンテナプロセスまで、数値IDのマッピングを確認する作業を、単一のコマンドではなく、観測可能な段階として扱います。

SMBまたはNFS経由でNAS共有を利用するLinuxコンテナホストでは、コンテナからNASのマウントパスが見えていても、権限エラーにより読み書きできないという実際上のリスクがあります。現在のIDと復旧ポイントを記録し、最も影響の小さい判別方法から始めて、別の変数を変更する前に成功・失敗の結果を解釈してください。ストレージが不安定になった場合や、復旧可能な唯一のコピーが危険にさらされる場合は中止してください。以下の手順では、元のワークロードが正常に動作するか、証拠がエスカレーションの境界に達した場合にのみ終了します。

実際のコンテナプロセスのIDを特定する

イメージのドキュメント、Composeのuser設定、環境変数、エントリポイントの動作、実行中のアプリケーションプロセスのUID、GID、補助グループを確認してください。PUIDやPGIDという名前の変数はイメージごとの規約であり、Dockerの共通機能ではないため、このイメージが対応していることを確認してください。

コンテナのPUIDとPGIDに関する権限の事例を取り上げたLinuxServerコミュニティの投稿では、PUIDとPGIDが正しく見えても、バインドマウントにアクセスできないことがあると示されています。この事例は、実行中のプロセスとマウントを確認するための参考として扱い、すべてのイメージが同じ初期化ロジックを実装している証拠とは見なさないでください。

コンテナ内とホスト上でidを使い、数値を記録してください。以前に権限エラーが起きたためにアプリケーションがrootでしか実行されていない場合は、作業を中止してください。rootアクセスはマッピングの不具合を隠し、サービスが侵害された場合の影響を大きくします。

NASからホストのマウントポイントまで所有権を追跡する

NAS上で、対象ディレクトリの数値の所有者、グループ、モード、ACL、デフォルトACLを確認してください。コンテナホスト上では、同じマウント済みオブジェクトを確認し、数値を比較してください。名前が異なっても数値が一致する場合、表示上の違いにすぎません。数値が異なる場合は、実際に認可の経路が異なっています。

NFSでは、エクスポートオプション、NFSバージョン、IDマッピング、root squash、クライアントのマウント時のIDを確認してください。SMBでは、マウント時の認証情報、サーバー側でマッピングされたID、uidまたはgidの表示オプション、Unix拡張またはACL変換が使用されているかを確認してください。

サーバーのACLとクライアントのマウントオプションを同時に変更しないでください。既知の数値所有者を持つテストファイルが1つあり、アンマウント、再マウント、再起動後もホスト上で安定したマッピングが確認できれば、この段階は合格です。

バインドマウントと補助グループをテストする

コンテナのソースパスが、ネットワーク共有のマウント前に作成された空のローカルディレクトリではなく、想定したホストマウントを指していることを確認してください。実行時のマウントを調べてから、使い捨てのサブディレクトリでアプリユーザーとして一覧表示、読み取り、作成、名前変更、削除をテストしてください。

Server Faultの事例では、所有者とACLエントリが一致しているように見えても発生するNFS ACLのアクセス許可の不一致が記録されています。このことから、ACLマスク、サーバー側のマッピング、実効IDをすべて調査する必要があるとわかります。ディレクトリと作成したファイルの両方でgetfaclを実行し、結果を記録してください。

グループアクセスが必要な場合は、サポートされている補助数値グループを追加し、プロセスのグループは起動時に固定されるため、コンテナを再作成してください。アプリが空のパスを対象に起動する場合は、ZimaSpaceのコンテナの空パス診断ガイドを参照してください。これはマウント順序の問題であり、ACLの問題ではありません。

最小限のID修正を適用して再テストする

アプリがサポートするUID、GID、または補助グループをNASのポリシーに合わせる方法を優先してください。複数のサービスが連携する場合は、共有グループと継承ACLを使用してください。安易な解決策として、全ユーザーに書き込み権限を与えること、無関係なデータセットに対して再帰的に所有権を変更すること、特権コンテナを使うことは避けてください。

コンテナを再作成し、マッピングオプションを変更した場合は共有を再マウントして、同じ操作をもう一度実行してください。ホストを一度再起動して、マウント順序と数値IDが起動後も維持されることを確認してください。コンテナに不要な権限を与えずに、新しく作成したファイルを想定したユーザーが引き続き書き込みできることを確認してください。

アプリが本来のワークロードを処理し、拒否されるべき操作が引き続き拒否され、再起動後も所有権が安定していれば、チェックリストを完了してください。ユーザー名前空間、rootlessのマッピング、またはNASのIDサービスが、選択したイメージでは対応できない形でIDを書き換える場合は、エスカレーションしてください。

サポートとヒント

続きを読む

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.