Dockerボリュームの復元でファイルの内容は再作成されるのに、拡張属性が失われるのはなぜですか?

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

Dockerボリュームの復元では、すべてのファイルのバイト列を再現できても、バックアップ形式、オプション、権限、復元先で保持できなければ、拡張属性が失われることがあります。

拡張属性は、通常のファイル内容、所有権、モードビット、タイムスタンプとは別に保存される、メタデータの名前と値のペアです。ACLデータ、SELinuxラベル、Linuxケイパビリティ、アプリケーションのマーカー、Sambaメタデータなどが格納されることがあります。単純なtarベースのボリュームバックアップでは、ディレクトリが完全に見えても、アーカイブにxattrsが記録されていなかったり、復元プロセスが保護された名前空間に書き込めなかったりすると、アプリケーションの動作が異なることがあります。

復元をやり直す前にソースの属性を一覧化する

代表的なファイルを選び、ハッシュ値、所有者、モード、ACL、すべての拡張属性の名前と値を記録してください。復元後にアプリケーションで問題が起きるファイルも含めてください。

Linuxのxattrモデルでは、user、system、security、trustedの名前空間が分かれており、それぞれアクセス要件と権限要件が異なります。

ソースにxattrsがなければ、復元時に失われたわけではありません。1つの名前空間だけが消えている場合は、アーカイブのファイル内容の層ではなく、権限、セキュリティポリシー、または復元先でのサポートに注目してください。

Dockerのバックアップコマンドが実際にアーカイブした内容を確認する

バックアップコンテナで使用したイメージ、コマンド、作業ディレクトリ、アーカイブ形式、ユーザー、マウントしたソース、マウントしたバックアップ先を正確に記録してください。

Dockerのボリュームのバックアップ例では、ヘルパーコンテナ内でtarを使用していますが、メタデータが保持されるかどうかは、引き続き使用するtarの実装とオプションに左右されます。

アーカイブファイルが正常に作成されたことは、ディレクトリエントリとデータ本体が読み取られた証拠にはなりますが、すべてのxattr名前空間が含まれている証拠にはなりません。作成に使用したものと同じツールでアーカイブを調べてください。

アーカイブの作成時と展開時に拡張属性を有効にする

バックアップと復元で使用したtarのオプションを比較してください。どちらの方向でもxattrsが有効になっていたこと、およびincludeまたはexcludeのパターンによって必要な名前空間が除外されていないことを確認してください。

GNU tar の説明によると、--xattrs は拡張属性を保存および復元します。

展開時にオプションを追加しても、保存されていない属性は復元できません。本番環境のバックアップを変更する前に、既知のテスト用 xattr が設定されたファイルから小さなアーカイブを新たに作成し、その内容を確認してください。

ファイルベースのバックアップには適切な Rsync メタデータオプションを使用する

ボリュームのバックアップに Rsync を使う場合は、送信側と受信側のアーカイブ、ACL、xattr、数値 ID、fake-super、権限に関するオプションを確認します。

Rsync の公式マニュアルでは、拡張属性を保持する -X が説明されており、特権メタデータを直接適用できない場合の fake-super による保存方法も記載されています。

一般的な -a アーカイブオプションでは、必要な ACL と xattr がすべて自動的に含まれるわけではありません。実際の送信元と保存先のファイルシステム間で、使用するコマンドをそのままテストしてください。

保存先のファイルシステムとマウントの対応状況を確認する

復元したボリュームに使い捨てのファイルを直接作成し、ユーザー xattr を1つ設定、一覧表示、削除できるか試します。ホスト経由とバックアップコンテナ経由の両方で繰り返します。

ホストと復元コンテナの両方で属性一覧表示ユーティリティを使い、バックアップアーカイブとは別に、保存先で xattr を設定でき、取得できることを確認します。

xattr の直接作成に失敗する場合は、ファイルシステムの種類、マウントオプション、ネットワークプロトコル、ボリュームドライバー、ストレージアプライアンスの対応状況を調べます。アーカイブのオプションを使っても、保存先が表現できないメタデータは復元できません。

セキュリティと信頼済み名前空間の権限を確認する

復元を実行するコンテナのユーザー、ケイパビリティ、ユーザー名前空間、ルートレスモード、SELinux ポリシー、およびボリュームパスがホストからバインドマウントされているかどうかを記録します。

Red Hat のドキュメントによると、ファイルをコピーまたは再作成した後、SELinux ラベルをポリシーに適合する形で復元する必要がある場合があります。

バックアップコンテナに、ホスト全体への広範な権限を恒久的に付与しないでください。管理された復元環境を使うか、まず通常のデータを復元してから、サポートされているツールでポリシー管理されたラベルを再適用してください。

ACL、ケイパビリティ、アプリケーション固有の拡張属性を分けて扱う

POSIX ACLエントリ、Linuxファイルケイパビリティ、SELinuxラベル、ユーザー拡張属性、SambaまたはmacOSのメタデータを個別に比較してください。それぞれ異なる理由で保持に失敗する可能性があります。

Sambaのxattr_tdbモジュールは、基盤となるファイルシステムとは別に拡張属性を保存できます。

そのため、ファイル単位のボリュームアーカイブでは、見た目のファイルツリーは保持できても、別のSambaメタデータデータベースは保持されないことがあります。依存するメタデータストアをすべて含めるか、アプリケーションがサポートする手順で再構築してください。

テストファイルを1つ復元し、アプリケーションを検証する

コンテンツハッシュ、ACL、ユーザー拡張属性、必要なアプリケーションメタデータを持つ既知のソースファイルを作成します。それをバックアップし、使い捨てボリュームに復元します。

ZimaSpaceの記事NASの権限とメタデータの変更では、より広範な移行動作を扱っています。この記事ではDockerボリュームのバックアップと復元に焦点を絞ります。

2回目の管理されたバックアップと復元の後、コンテンツハッシュ、必要な拡張属性の名前と値、ACL、セキュリティラベル、アプリケーションの動作がすべて一致すれば、問題は解決したといえます。

よくある質問

拡張属性とACLは同じものですか?

いいえ。一部のファイルシステムではACLがシステム拡張属性を使って実装されることがありますが、拡張属性にはセキュリティラベル、ケイパビリティ、ユーザーメタデータ、アプリケーション固有の値も保存されます。

tarはデフォルトで拡張属性を保持しますか?

そうとは限りません。GNU tarには拡張属性を扱う明示的なオプションがあり、展開時に復元するには、アーカイブ作成時に属性が保存されている必要があります。

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.