バックアップの失敗がリポジトリとソースファイルのどちらに起因するかを見分ける方法

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

小さく安定したソースを使ってリポジトリの読み取りを単独でテストし、その後、疑わしいソースパスを新しい使い捨てリポジトリに対してテストします。

読み取り、チェックサム、権限、パック、インデックスのエラーでバックアップが停止した場合、この判断が重要になります。競合する可能性があるのは、リポジトリまたは保存先の破損と、ソースファイルの読み取り、権限、または変更に関するエラーです。保存済みの構成と使い捨てデータを使い、各分岐を1つずつ観察します。テストによってデータ損失、権限、可用性のリスクが高まる場合は中止します。

リポジトリまたは保存先の破損と、ソースファイルの読み取り、権限、または変更に関するエラーを切り分ける

変更を加える前に、ソフトウェアとファームウェアのバージョン、デバイスの識別情報、マウント先またはネットワークパス、空き容量、権限、確認できる症状など、環境の情報を記録します。ベースラインには、読み取り、チェックサム、権限、パック、インデックスのエラーでバックアップが停止した状況を再現するのに十分な詳細を残します。

最初の候補は、リポジトリまたは保存先の破損です。2つ目は、ソースファイルの読み取り、権限、または変更に関するエラーです。現在のResticのトラブルシューティング手順は、テストで使う仕組みやコマンドの境界を定めるものであり、このホームサーバー固有の観察に取って代わるものではありません。

判別テストを実施する前に、合格条件と中止条件を記述します。合格とは、一方の仮説が予測する証拠に変化があり、無関係なサービスには変化がないことです。不合格の場合は、推測に基づく修正を次々と試すのではなく、システムを保存済みの状態に戻します。

判別テストを1つだけ実施する

この判別テストを実施します。リポジトリのチェックとカナリア復元を行い、読み取り可能な固定テストセットをバックアップしてから、ソース側のエラーを個別に調べます。結果を変更した変数に帰属できるよう、ワークロード、クライアント、パス、ファイルセット、タイミングを一定に保ちます。

独立したResticのワークフローを使って、分岐を実際に見分けられる項目を選び、タイムスタンプ、終了ステータス、エラーテキスト、デバイスまたはスナップショットの識別情報、レイテンシ、転送バイト数、権限、復旧状態を記録します。アイデンティティ、耐久性、アプリケーションの状態が検証対象である場合、コマンドがエラーなく終了しただけでは不十分です。

再起動、再接続、再マウント、またはキャッシュが空の状態が元の条件に含まれる場合は、その後にテストをもう一度繰り返してください。最初の実行が破壊的になる場合、または環境を復元できない場合は中止し、使い捨てのコピーで再現してください。

restic check
restic restore latest --include /canary --target /tmp/restore-test

証拠がどちらの分岐を裏付けるか判断する

合格: リポジトリの検査または復元が複数のソースで失敗するか、リポジトリは健全なまま特定のソースパスだけが失敗します。結論が一般論にならず条件付きのまま保たれるよう、合格した正確なバージョン、ID、ワークロードを記録してください。

失敗: ネットワーク障害とメモリ障害が両方のテストに影響する場合は、どちらかが損傷していると判断する前にローカルで再現してください。ネットワーク、メモリ、権限、またはソースの整合性が両方の分岐に影響しうる場合、失敗は自動的に反対側の分岐を証明するものではありません。エスカレーションする前に、これらの共通依存関係を切り分けてください。

例外または結果が曖昧な場合: 破壊的なメンテナンスを中止し、ログをコピーして、最後に正常だったリポジトリの状態を保護してください。ログを保存し、復元可能なコピーが存在するまでは、repair、prune、destroy、repartition、または再帰的な所有権変更コマンドを実行しないでください。

該当する処置を適用し、元の障害を再現する

観測された分岐に合った処置を適用し、縮小した代替条件ではなく、元の条件を再度試してください。この判断が成り立つのは、リポジトリの検査または復元が複数のソースで失敗する場合、あるいはリポジトリが2サイクル、または該当する再起動、スリープ、中断、負荷の遷移を通じて健全なまま、特定のソースパスだけが失敗する場合に限られます。

Resticのパックサイズを使って、最も近い依存ワークフローを確認してください。ただし、元のトリガーは変更しないでください。無関係なデータセット、共有、コンテナ、ユーザー、復旧ポイントは、以前のアクセス権とタイミングを維持する必要があります。

停止条件は明確です。ネットワーク障害とメモリ障害が両方のテストに影響する場合は、どちらかが損傷していると判断する前にローカルで再現してください。最後に検証済みの構成に戻し、証拠を保存します。分岐が再現可能な場合に限り、さらに詳しいプラットフォームテストまたはハードウェアテストに進んでください。

対象の結果が得られたら、検証頻度と照らし合わせ、リスクが隣接するサービスに移っていないことを確認してください。対象のテストに成功しても、新たにバックアップ、ID、タイムアウト、または可用性の問題が発生した場合は、変更は失敗です。

よくある質問

バックアップの失敗を切り分ける際、残る検索項目は通常、「リポジトリのチェックに成功すればソースが網羅されていると証明できるか」「リポジトリはすぐに修復すべきか」「見落としやすいソースエラーにはどのようなものがあるか」です。以下の回答では、こうした例外的なケースを主要な判断基準と分けて説明します。

合否判定の基準は変わりません。ソースを問わずリポジトリのチェックや復元に失敗するか、リポジトリが正常なまま特定のソースパスだけが失敗するかです。その後の条件によってファイルシステム、ID、ネットワーク経路、またはアプリケーションのバージョンが変わった場合は、その変更の影響を受ける判別テストだけを繰り返してください。

ネットワークやメモリの障害が両方のテストに影響している場合は、実験の範囲を広げるのをやめ、どちらかが破損していると判断する前にローカルで再現してください。この時点で、破壊的なメンテナンスを凍結し、ログをコピーして、最後の正常なリポジトリの状態を保護してください。プラットフォーム、ストレージ、またはハードウェアの担当者にエスカレーションする前に、証拠を保全してください。

リポジトリのチェックに成功すれば、ソースが網羅されていると証明できますか?

いいえ。リポジトリの特性は確認できますが、対象となるソースファイルがすべて読み取り可能だったことや、すべて含まれていたことまでは証明できません。

リポジトリはすぐに修復すべきですか?

実行可能な範囲で安全なコピーを作成し、障害の種類を確認するまでは、行わないでください。

見落としやすいソースエラーには、どのようなものがありますか?

権限拒否、消失するファイル、読み取り不能なセクター、スパースファイル、アプリケーションの整合性に関する問題は、サマリーに表示されないことがあります。

同じワークロードで、証拠がリポジトリまたは保存先の破損を示すのか、それともソースファイルの読み取り、権限、変更に関するエラーを示すのかが再現され、該当する対処によって元の症状が解消し、新たな問題が生じなければ、診断は完了です。どちらのパターンも再現性が保てない場合は、ログと保存済みの状態をそのまま保持してください。不確実な場合は、修正を重ねるのではなく、エスカレーションしてください。

サポートとヒント

続きを読む

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.