2台のホームサーバー間でDockerの名前付きボリュームを移行するワークフロー

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

安全な方法では、停止状態で作成したアーカイブ、または明示的に特定した移行先ボリュームへの同期コピーを、チェックサム確認とアプリケーションの検証まで含む、観察可能な複数のゲートから成る手順として扱います。単一のコマンドで済むと考えてはいけません。

Docker Composeを実行する2台のLinuxホームサーバー間で、実務上のリスクとなるのは、稼働中または名前を誤ったボリュームをコピーしてしまうことなく、状態を持つコンテナを別のホストに移動することです。現在の識別情報と復旧ポイントを記録し、最も影響の少ない判別方法から始めてください。別の変数を変更する前に合否の結果を解釈し、ストレージが不安定になった場合や、唯一の復旧可能なコピーが危険にさらされる場合は作業を中止します。以下の手順を続けるのは、元のワークロードが正常に動作するか、証拠からエスカレーションが必要と判断できる段階に達した場合に限ります。

コピー元と移行先のボリューム要件を特定する

コピー元のコンテナイメージのダイジェスト、Composeプロジェクト名、サービス、ボリュームキー、実際のDockerボリューム名、マウント先、ボリュームドライバー、アプリケーションのバージョンを記録します。docker inspectとdocker volume inspectを使い、YAMLのラベルだけから物理パスを推測しないでください。

明示的な名前または外部ボリュームを使わない限り、Composeでは通常、プロジェクト名が名前付きボリュームの先頭に付加されます。移行先でCompose設定をレンダリングし、意図した空のボリュームを明示的に作成してください。これにより、サービスが別のボリュームを起動する一方で移行データが別のボリュームにコピーされる事態を防げます。

ボリュームにデータベースがある場合は、移植可能な主な復旧手段としてネイティブのダンプまたはサポート対象のバックアップを使い、ボリュームコピーは同一バージョンでの復旧ポイントとして扱います。ドライバーがリモートである場合、コピー元のストレージが不安定な場合、または対象外の追加ボリュームにもアプリケーションの状態が分散している場合は、作業を中止してください。

書き込みを停止し、メタデータを保持したコピーを作成する

アプリケーションをメンテナンスモードにし、バックグラウンドジョブを停止してから、アプリケーションとデータベースを適切に停止します。どのコンテナもボリュームを読み書き可能な状態でマウントしていないことを確認してください。一時コンテナを使ってアーカイブを作成するか、数値の所有者情報、権限、シンボリックリンク、必要に応じて拡張属性、スパースファイルを保持する制御されたファイルシステムコピーを使用します。

独立したrsyncを使ったDockerボリュームの移行ガイドでは、rsyncを使ってDockerボリュームのデータを移動する方法が紹介されています。重要なのは、コピー元が静止状態であり、コピーコマンドがDockerデーモンの使用中に内部ディレクトリをむやみに操作するのではなく、特定済みのボリューム内容を対象にすることです。

ファイル数、合計バイト数、代表的なハッシュ値、アーカイブのチェックサムを含むマニフェストを生成してください。元のボリュームとネイティブバックアップには手を加えず、転送データを移行先ホストで読み取れることを確認してからコピー工程を完了します。

明示した移行先ボリュームへ復元する

移行先のファイルシステム容量、inodeの空き状況、想定されるUIDとGID、同じアプリケーションイメージのバージョンを確認してください。最上位ディレクトリの構造を崩さずに、空の移行先ボリュームへアーカイブを復元し、所有権、件数、サイズ、選択したハッシュ値を比較します。

名前付きボリュームの移行失敗事例に関するコミュニティの議論から、Dockerのボリューム内部にあるファイルを直接置き換えると、失敗したり、状態がわかりにくくなったりする理由がわかります。実行環境を使ってヘルパーコンテナにボリュームをマウントし、その制御されたインターフェースを通じて復元してください。

まず、使い捨てのコピーだけをサービスに接続し、代替ポートを使用して、本番環境の接続先にはアクセスさせないでください。アプリケーションがスキーマのアップグレードや状態の破損を報告した場合は停止し、バージョンの互換性を解決した後、変更されていないバックアップデータからボリュームを復元し直してください。

切り替えを行い、ロールバック用のホストを維持する

アプリケーションの前に依存サービスを起動し、ログ、ログイン、最近のレコード、添付ファイル、スケジュール済みジョブ、一時的な書き込みを確認します。移行先のスタックを再起動し、同じ名前付きボリュームが再接続されることを確認してください。これらのチェックに合格してから、プロキシまたはDNSを更新します。

コンテナデータの整合性を保つバックアップに関するZimaSpaceの記事は、コピーに成功したのに移行先が空のままの場合に役立ちます。再度データをコピーする前に、実行時のマウント元と想定しているボリュームを比較してください。間違った移行先へ何度もコピーすると、状況がわかりにくくなるだけです。

移行先での新しいバックアップと復元テストが成功するまで、元のアプリケーションは停止したままにし、古いボリュームは読み取り専用にしてください。移行先で新しい書き込みが受け付けられていない場合に限り、変更されていない元の環境へトラフィックを戻してロールバックします。それ以外の場合は作業を停止し、データを慎重に照合してください。

サポートとヒント

続きを読む

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.