restic 0.20.0でバックアップの除外対象を確認する方法

バックアップから一時ファイルを外したつもりでも、集計の件数だけでは、必要な資料まで外していないか判断しづらいものです。11月19日公開のrestic 0.20.0では、backup -vvで除外されたパスを表示できます。プロジェクトの作業フォルダーを例に、ルールを試してから実際に保存された内容を確かめます。

青緑色のポータブルドライブの横に紙フォルダーが並び、黄土色の一冊が離れている
バックアップする資料と除外する資料を分けるイメージ。
目次

残すファイルと除外するファイルを決める

以下はLinuxやmacOSのシェル向けの例です。restic versionで0.20.0以降であることを確認し、/srv/restic-repoを利用中のリポジトリに、~/work/projectを読み取り可能な作業フォルダーに置き換えます。残したい資料を一つ選びます。たとえばbrief.mdです。

対象フォルダーの外にルールファイル~/backup-rules.txtを用意します。次の例では、依存パッケージのフォルダーと拡張子が.tmpのファイルを除外します。各パターンを別々の行に書きます。

node_modules
*.tmp

予行演習で除外されたパスを読む

restic -r /srv/restic-repo backup ~/work/project --exclude-file ~/backup-rules.txt --dry-run -vv

--dry-runを付けるとリポジトリに書き込みません。出力のexcludedに続くパスを見て、実在するdraft.tmpやnode_modulesが想定どおりに対象外になったか確認します。ディレクトリごと除外されると、中のファイルを一つずつ列挙しないので、残す予定の資料の親フォルダーにも注目してください。

自動集計する場合は同じ予行演習に--jsonを加えます。message_typeがexcluded_itemの行のitemが対象パスです。除外されるはずのファイルを引数に直接指定すると、その明示的なパスには除外ルールが適用されません。上の例のように親フォルダーを渡して試します。

保存したスナップショットで資料を照合する

出力が想定と違えばルールを直して再度予行演習します。問題がなければ、同じ対象とルールでバックアップを実行します。完了時に表示されるスナップショットIDを控えてください。

restic -r /srv/restic-repo backup ~/work/project --exclude-file ~/backup-rules.txt

下のa1b2c3d4を実際のIDに置き換えます。一覧にbrief.mdがあり、除外したdraft.tmpがないことを照合すれば、今回保存した世代でルールが効いたことを確認できます。

restic -r /srv/restic-repo ls a1b2c3d4

restic 0.20.0 リリースノート · 公式ガイドの除外ルール

この記事を書いた人

実務の現場で詰まりがちなポイントを地図にするITブログ「IT trip」を運営。Windows/Office(Teams・Excel)からSQL、サーバ運用、ガジェットまで、再現性のある手順と“なぜそうなるか”を丁寧に解説します。読んだらすぐ試せること、そして迷った人の次の一歩が見えることを大切にしています。

コメント

コメントする

目次