Resticリポジトリのメンテナンス手順:チェック、プルーニング、圧縮、復元テスト

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

安全に進めるには、スケジュールの調整、健全性チェック、保持対象のプレビュー、pack再構成のためのprune、再チェック、隔離された環境での復元を、単一のコマンドではなく、結果を確認できる一連のゲートとして扱います。

1台以上のホームサーバーホストで使用するResticリポジトリでは、実際に問題となるのは、バックアップを妨げずにリポジトリをメンテナンスすることと、容量の回収を復元可能性と取り違えないことです。現在の識別情報と復旧ポイントを記録し、影響の最も小さい判別手順から始めます。別の変数を変更する前に成功・失敗の結果を判断し、ストレージが不安定になった場合、または復元可能な唯一のコピーが危険にさらされる場合は中止してください。以下の手順は、元のワークロードが正常に動作するか、証拠からエスカレーションが必要と判断できた場合にのみ完了します。

リポジトリ全体のメンテナンス時間を確保する

リポジトリにアクセスできるすべてのホストで、バックアップ、forget、check、copy、pruneのスケジュールを一時停止します。稼働中のロック所有者がいないことを確認し、ResticのバージョンとリポジトリIDを保存します。認証情報をシェル履歴やログに残さずに、認証情報をテストしてください。リポジトリのメンテナンスは、コンテナごとの作業ではなく、共有状態に対する一つの変更です。

以前のクラッシュでロックが残った場合は、ロックを解除する前に、ZimaSpaceの手順に従ってクラッシュ後にロックされたResticリポジトリに対処してください。ロックは所有者がいる証拠です。記載されたプロセス、ホスト、タイムスタンプ、バックエンドの動作から処理が終了していると確認できた場合に限り、ロックを削除してください。

バックエンドの空き容量、inode数またはオブジェクト数の上限、書き込み権限、ローカルキャッシュや一時領域を確認します。ストレージパスが不安定な場合、イミュータブル保持設定によって必要な削除が妨げられる場合、または別の書き込み元を一時停止できない場合は中止してください。

構造を確認し、リポジトリのデータをサンプルチェックする

restic snapshotsと通常のrestic checkを実行し、出力と終了ステータスを保存します。その後、リポジトリのサイズと帯域幅に応じて、--read-dataまたはサポートされているデータ読み取りの一部を実行するようスケジュールします。構造チェックに成功しても、すべてのpackが読み取り可能だと証明されたわけではありません。

Resticコミュニティでの議論では、日常的なcheck、prune、rebuild-indexの役割を区別し、インデックスの再構築は通常の予防保守ではないと説明されています。checkに時間がかかるからといってrebuild-indexを実行したり、packファイルを削除したりしないでください。復旧コマンドは、不整合を特定した場合に限って使用します。

checkでパックの欠落、ハッシュの不一致、バックエンドの読み取り失敗、またはインデックスの不整合が報告された場合は、pruneの前に停止してください。リポジトリを保護し、安定した経路で失敗した読み取りのみを再試行し、コピー上で文書化された復旧手順に従ってエスカレーションしてください。

保持ポリシーをプレビューしてから、pruneと再パックを実行する

意図したrestic forgetポリシーを--dry-runで実行し、ホスト、パス、タグごとに保持・削除されるスナップショットを確認してください。必要な復旧ポイントが一覧に残る場合にのみforgetを実行してください。可能であれば、ポリシーの試験的な変更を行う際は、最近検証済みのスナップショットを別途保持してください。

Resticでは「compact」は独立したコマンドではありません。pruneは参照されていないデータを削除し、必要に応じてリポジトリファイルを再パックします。最新のトラブルシューティングガイドでは、Resticのprune失敗について説明しており、空き容量やロックの問題など、次の破壊的な操作の前に解決すべき問題も取り上げています。

バックアップを並行実行せずにpruneを1回実行し、完全なログを保存してください。失敗した場合、やみくもに再実行したり、一時ファイルに見えるオブジェクトを削除したりしないでください。ロック、空きワークスペース、バックエンドの権限、最後に完了したフェーズを再確認し、診断のためにリポジトリの状態を保持してください。

再確認し、隔離した環境で復元を実施する

整理に成功したら、restic checkを再実行し、予定していたデータ読み取り範囲の確認を完了してください。スナップショット数、リポジトリのサイズ、エラーをメンテナンス前のベースラインと比較してください。保持中のスナップショットが引き続きデータを参照している場合、空き容量の減少が推定値どおりでなくても失敗ではありません。

最近のスナップショットと、古いスナップショットから代表的な一部を、空のディレクトリに復元してください。ファイルの内容、権限、タイムスタンプ、シンボリックリンク、およびアプリケーションレベルの成果物を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.