突然読み取り専用になったDockerのバインドマウントを修正する方法

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

Dockerが読み取り専用パスを受け取った場合、またはホストファイルシステムが書き込みを受け付けなくなった場合、Dockerのバインドマウントは読み取り専用になります。

バインドマウントはホストのパスをコンテナ内に直接公開するため、コンテナ単独では、基盤となるディスク、ファイルシステム、マウントフラグ、セキュリティポリシーを修復できません。最も安全な復旧方法は、書き込みを停止し、コンテナのマウントとホストのマウントを比較して、読み取り専用の動作が設定によるものかエラーによって発生したものかを特定し、アプリケーションを再起動する前にストレージの健全性を回復することです。

どのパスが読み取り専用か確認する

コンテナ内のバインド先で影響のない書き込みを試し、ホスト上のソースパスでも別の書き込みを試してください。すべての権限エラーが読み取り専用ファイルシステムを意味すると思い込まず、正確なエラーを記録してください。

Dockerフォーラムの事例では、必要なディレクトリを読み取り専用の親ファイルシステム上に作成できないため、読み取り専用の親バインドマウントによってDockerがネストされたマウントポイントを作成できなくなることが示されています。

ホストでは書き込めるのにコンテナでは書き込めない場合、Dockerのマウントオプションとセキュリティ制御を確認してください。両方で読み取り専用ファイルシステムのエラーが発生する場合は、コンテナのユーザー設定の変更を止め、ホストのマウントとストレージデバイスの調査に移ってください。

Dockerの実効マウントフラグを確認する

現在のComposeファイルだけでなく、実行中のコンテナ設定を確認してください。ソース、宛先、伝播モード、および:ro、ロング構文、オーバーライドファイル、デプロイツールのいずれかによってマウントが読み取り専用に設定されていないかを確認します。

Dockerクライアントの問題を扱った事例では、実行時の設定が意図した読み書き可能な構成と異なっていたため、マウントされたパスが読み取り専用に見えるケースが記録されています。重要な証拠は、実行中のコンテナに適用されている実効マウントモードです。

マウントが意図的に読み取り専用になっている場合、アプリケーションが本当に書き込みを必要とするときに限り、そのフラグを解除してください。宣言を変更した後はコンテナを再作成してください。Composeファイルを編集しても、既存のマウントには変更が遡って適用されません。

ホストがファイルシステムを読み取り専用で再マウントしたか確認する

ホストのマウントテーブル、カーネルログ、ストレージログ、ファイルシステムの状態を確認し、I/Oエラー、ジャーナル障害、チェックサムエラー、デバイスのリセット、または保護のための再マウントがないか調べてください。保護が有効になった理由を把握する前に、強制的に読み書き可能な状態で再マウントしないでください。

Unraidのサポート事例では、ファイルシステムが読み取り専用になった後にDockerのappdataが機能しなくなり、Plexのディレクトリ作成時にもエラーが発生しています。このパターンは、コンテナの権限設定ではなくホストファイルシステムの障害を示しています。

影響を受けるコンテナを停止し、診断情報を保管してください。プラットフォームがサポートするメンテナンス手順に従って、ディスク、プール、ケーブル、ファイルシステム、またはジャーナルを修復します。データベースやメディアのコンテナで再び書き込みを許可する前に、ホストパスが正常であることを確認してください。

入れ子や重複のあるマウントを調べる

マウント済みディレクトリの内側をマウント先とするバインドマウントと名前付きボリュームをすべて列挙してください。マウントの重なりによってディレクトリが隠れたり、予期しないアクセス動作を継承したり、読み取り専用の親ディレクトリの下にマウントポイントをDockerが作成する必要が生じたりすることがあります。

Server Faultのディスカッションでは、関連するコンテナパスに読み書き可能なマウントと、より広範囲の読み取り専用マウントを重ねると、結果が分かりにくくなることが説明されています。このバッチ内ですでにそのドメインが使われているため、ここでの実用的なルールは、権限を変更する前にマウント先のツリー全体を把握することです。

コンテナを起動する前に必要なホストディレクトリを作成し、ランタイムが作成する必要のある読み取り専用の親ディレクトリの下に、書き込み可能な子ディレクトリをマウントするのは避け、Composeでは永続パスを明示してください。マウント構成を単純化してからコンテナを再作成します。

読み取り専用の状態を権限やセキュリティポリシーの問題と区別する

書き込みテストのエラーを、ソースディレクトリの所有者、モード、ACL、SELinuxラベル、AppArmorプロファイル、コンテナのユーザーIDと照らし合わせてください。「権限が拒否されました」と「ファイルシステムが読み取り専用です」は異なるエラーであり、それぞれ別の修復が必要です。

ストレージのトラブルシューティングガイドでは、読み取り専用ボリュームの問題をマウントフラグ、ファイルシステムエラー、セキュリティコンテキスト、ストレージドライバーの問題に分類しています。この分類により、ストレージ層が読み取り専用になっている状態に対して、安易にchmod 777を実行するのを防げます。

権限に問題がある場合は、想定するコンテナのUIDとGIDを使って、ホスト上の所有者またはACLを修正してください。ファイルシステム自体が読み取り専用の場合、権限の変更は失敗するため、ファイルシステムの修復の代わりにしてはいけません。

ホストでの書き込みテストに合格してからアプリケーションを再起動する

ホストパス上で一時ファイルの書き込み、同期、読み取り、削除を行い、同じマウント宣言とユーザーを使って一時的なテストコンテナからも同じ操作を繰り返します。再起動後も想定したファイルシステムがマウントされた状態であることを確認してください。

ストレージが書き込み可能になった後もアプリケーションの再起動が続く場合は、ZimaSpaceガイドのコンテナの再起動を引き起こす依存関係の特定を次に確認してください。

ホストファイルシステムが正常であること、実際に適用されるDockerマウントが設計どおり読み書き可能であること、アプリケーションが永続ファイルを更新できること、そして継続使用中に新たなI/Oエラーやファイルシステムエラーが発生しないことを確認して、初めて修復完了となります。

サポートとヒント

続きを読む

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.