マウントパスを維持したままコンテナデータをSSDプールに移動する方法

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

各コンテナ側の宛先パスはそのままにして、ホスト側のデータソースをSSDに移動します。

安全な移行では、現在のマウント構成をインターフェース契約として扱います。コンテナ、データベース、メディアアプリは、どのディスクがデータを供給するかに関係なく、/config、/data、/mediaなどのパスを想定しています。書き込みを停止し、SSDを確実にマウントして、所有権とメタデータを保持したままデータをコピーし、ホスト側のソースのみを更新して、起動前に新しいマウントを確認します。完全な復元テストに成功するまでは、元のデータを保持してください。

現在のすべてのソースとコンテナ側の宛先を一覧にする

Composeファイルまたはコンテナの検査データをエクスポートし、すべてのバインドマウント、名前付きボリューム、tmpfsマウント、データベースディレクトリ、キャッシュ、トランスコード先、メディアの場所を一覧にします。ホスト側のソースとコンテナ側の宛先は、それぞれ分けて記録してください。

実用的なボリューム移行ガイドでは、まず現在のデータの場所を特定し、コンテナを停止してから新しいディスク上の場所にコピーします。こうして一覧化しておけば、設定データがシステムディスクに取り残されるのを防げます。

どのパスに正規の状態データ、再生成可能なキャッシュ、大容量メディアが含まれるかを確認します。dataという名前のフォルダーにアプリケーションの永続データがすべて含まれているとは限りません。

Dockerの起動前にSSDプールを確実にマウントする

SSDのファイルシステムまたはプールを作成し、安定したUUIDまたはプール名で識別して、最終的なホストパスにマウントします。再起動後に、空き容量、必要なファイルシステム機能、書き込み権限を確認してください。

外部ストレージへのDockerデータの移動は、起動時にディスクがない場合や、異なるパスにマウントされている場合に失敗することがあります。外付けSSDに関する最近の事例は、Dockerストレージの移動によって移行先のマウントパスへの依存が生じることを示しています。

Dockerがシステムディスク上に空の代替ディレクトリを作成しないよう、サービスの起動順序や自動マウントの動作を設定します。SSDが想定どおりのパスにマウントされていない場合は、処理を中止してください。

書き込みプロセスを停止して、メタデータを保持したままデータをコピーする

アプリケーションと、データを書き込む可能性のあるすべての依存サービスを停止します。データベース、インデクサー、ダウンローダー、バックグラウンドジョブも含まれます。データベースの場合は、ファイルをコピーする前に、アプリケーション整合性のあるダンプを取得するか、正常にシャットダウンしてください。

Synologyのコンテナに関する議論では、Docker管理のボリュームをバインドマウントに移す前に、ボリューム内のデータを特定し、新しいバインドマウントのソースにその内容を保持することが推奨されています。

再帰的にコピーし、対応している場合は所有権、権限、タイムスタンプ、リンク、ACL、拡張属性を保持します。Composeを変更する前に、差分のドライランまたはサンプルのチェックサム比較を実行します。

ホスト側のソースパスのみを変更する

コンテナ内の保存先は同じままにします。たとえば、アプリケーションに新しい内部パスを設定するのではなく、/oldpool/app:/configを/ssdpool/app:/configに変更します。

バインドマウントは、ホスト上の特定の場所をコンテナ内の固定パスに公開します。ストレージの概要では、この直接マッピングが、管理者がホスト側のパスを制御する必要がある場合に役立つと説明しています。

保存先を維持すれば、アプリケーションのデータベース、ライブラリの参照、スクリプト、権限、コンテナ内のパスを記録した設定値が損なわれるのを防げます。

所有権、ラベル、データベースの整合性を復元する

イメージが想定する数値のUIDとGIDを、SSD上の所有者情報と照合します。また、ロックやメモリマップトファイルに必要なACL、SELinuxラベル、AppArmorの許可設定、マウントオプションも復元します。

macOS向けのDockerストレージ移行ガイドでは、Dockerデータの移設にはストレージイメージ全体のコピーが必要で、その後、ランタイムが新しいストレージの場所を使用していることを確認すると説明しています。Linux NASシステムでは、設定したすべてのソースがマウント済みのSSDを参照していることが同等の確認項目です。

データベースだけを起動し、依存するアプリを起動する前に復旧ログを確認します。破損またはファイルの欠落が報告された場合は、アプリケーションが空のデータベースを初期化しないよう、停止して元のコピーに戻してください。

ロールバック手順を確保して切り替え、ワークフロー全体をテストする

依存関係の順序に従ってスタックを起動し、設定、データベースのレコード、権限、メディアライブラリ、アップロード、ダウンロード、更新、コンテナの再作成を確認します。新しい書き込み先がSSDであることと、システムディスクの使用量が増えなくなったことを確認してください。

ZimaSpaceの記事「Dockerのバインドマウントが読み取り専用になる」では、移行したパスがマウントされるものの書き込みが拒否される場合の次の診断方法を解説しています。

バックアップと2回目のコンテナ再構築がSSDのパスから成功するまで、古いデータはオフラインのまま変更せずに保管してください。ロールバック演習で、Composeファイル、マウント、データベース、アプリケーションの状態を復元できることを確認してから、古いデータソースを削除してください。

サポートとヒント

続きを読む

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.