リポジトリを新しいストレージに移行するためのBorg Backup移行ガイド

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

安全な方法は、書き込みの停止、バージョンに適した方法でのコピーまたは転送、コピー先の検証、ロールバック手段を確保した切り替えを、単一のコマンドではなく、確認可能な段階を踏んで行うことです。

ローカル、NAS、または SSH でアクセスできるストレージ上の BorgBackup リポジトリでは、リポジトリの分裂や、気づかないうちに不完全なコピーが作成されないように移行することが実際上の課題です。現在の ID と復旧ポイントを記録し、影響が最も小さい判別方法から始め、別の条件を変更する前に合格・不合格の結果を解釈し、ストレージが不安定になった場合や、唯一の復旧可能なコピーを危険にさらすことになる場合は作業を中止してください。以下の手順は、元の処理が正常に動作するか、証拠がエスカレーションの境界に達した時点でのみ完了します。

コピー前にリポジトリの要件を記録する

Borg のバージョン、リポジトリ URL、リポジトリ ID、暗号化モード、鍵の保存場所、パスフレーズの復旧手順、アーカイブ一覧、サイズ、空き容量、追記専用設定、書き込み可能なすべてのクライアントや自動化ジョブを記録します。ローカルキャッシュだけではリポジトリを復旧できません。また、暗号化されたリポジトリは、コピー先以外に保存された鍵の情報に依存している場合があります。

ZimaSpace のBorg のキャッシュを失った場合の復旧ガイドでは、再構築可能なキャッシュの状態と、失われた鍵やリポジトリの損傷を区別しています。移行前にこの確認を行い、古いストレージを手放した後で初めて鍵の問題に気づく事態を避けてください。

同じリポジトリをバイト単位でそのまま移すのか、新しく初期化したリポジトリに転送するのかを選びます。利用できる方法は Borg のバージョンと形式によって異なります。Borg 1 と Borg 2 のコマンド例を混在させたり、リポジトリの ID を変更すべきだと決めつけたりしないでください。

書き込みを停止して、一貫性のあるコピー元の状態を作成する

タイマー、cron ジョブ、コンテナ、リモートクライアントを無効にし、Borg プロセスもリポジトリロックもアクティブでないことを確認します。コピーの前に borg list と適切な borg check を実行してください。コピー元のチェックに失敗した場合は、その状態を保全し、不確かな状態をコピー先に持ち込むのではなく、原因を調査してください。

Super User のディスカッションでは、重複排除された Borg リポジトリの内容が変化している間にrsync で稼働中のリポジトリをコピーするリスクが指摘されています。安全のため、変更が止まったリポジトリをコピーするか、すべての Borg 書き込みプロセスを停止した後に取得したファイルシステムスナップショットを使い、インデックス、セグメント、nonce の状態、データがすべて同じ時点のものになるようにしてください。

移行先の検証が終わるまで、バックアップスケジュールを停止しておいてください。停止時間が長くなりすぎる場合は、リポジトリがアイドル状態の間に初回コピーを行い、書き込み元を停止してから最終同期を実行します。切り替え中に移行元と移行先の両方で、独立してバックアップを受け付ける状態にしないでください。

お使いのBorgバージョンがサポートする方法でコピーする

同一リポジトリを別の場所に移す場合は、適切なローカルまたはリモートのコピー用ツールを使い、すべてのファイル、権限、スパースファイルの扱い、所有者情報を保持して、エラーログを確認してください。選択したアーカイブや、容量が大きそうなデータディレクトリだけではなく、リポジトリのルート全体を単位としてコピーしてください。最終同期後は移行元を変更しないでください。

新しいリポジトリまたは形式の移行では、インストール済みのBorgバージョンと暗号化計画でサポートされている場合に限り、転送機能を使用してください。Server Faultの回答では、Borgリポジトリ転送はBorg 2に関連するリポジトリ間の転送として説明されており、Borg 1のファイルシステムコピーと同じものではありません。

コピー後、まず移行先を読み取り専用でクライアントにマウントするか、公開してください。リポジトリID、鍵へのアクセス、権限、形式に想定外の点があれば、処理を停止して移行先を修正します。コピーしたデータに対して「初期化」を実行したり、認識させるために修復を実行したりしないでください。

アーカイブを検証し、クライアントを切り替えて、ロールバック手段を保持する

移行先で Borg list、info、および適切なリポジトリとアーカイブのチェックを実行します。最近のアーカイブと古いアーカイブからカナリアファイルを別のディレクトリに展開し、内容、メタデータ、権限を比較します。自動化で使うものと同じ Borg バイナリとリモートパスでテストしてください。

クライアントを1台だけ新しいURLに更新し、Borgが必要と判断したキャッシュ状態のみをクリアまたは再構築して、小さなテストアーカイブを作成します。そのアーカイブから復元し、すべてのクライアントが新しい場所を使うまでは、プルーニングやコンパクトのスケジュールが無効のままであることを確認します。

アーカイブ一覧が一致し、チェックに合格し、2つの復元が正常に行え、再起動またはスケジューラーの再起動後に新しいバックアップが成功すれば、切り替えは完了です。通常のサイクルを少なくとも1回終えるまでは、移行元を読み取り専用のままにしてください。ロールバック期間が終了してから移行元を削除するか、移行元と移行先でチェック結果が異なる場合はエスカレーションしてください。

サポートとヒント

続きを読む

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.