正常なバックアップからImmichデータベースを復元する方法

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

正常に動作しているImmichのデータベースバックアップは、管理された状態で復元し、復元したデータベースがサーバーから実際に参照できるメディアを指していることを確認して初めて役立ちます。

復旧は単一のインポートコマンドではなく、一連の手順として進めてください。まず障害が起きたインスタンスを保全し、Immichのバージョンとバックアップのタイムスタンプを特定します。次に、互換性のあるクリーンなデータベース環境を起動し、アプリケーションが空のスキーマに先に書き込まないようにしてから復元します。その後、アカウント、タイムラインデータ、メディアのパスを確認し、新たに1件書き込めることも検証してください。手順に曖昧な点があれば、復元可能な最後のコピーを置き換える前に作業を止めてください。

復元の前に、障害発生時の状態を保全する

復旧作業を始める前に、影響を受けたImmichインスタンスへの新規アップロードとバックグラウンドでの書き込みを停止してください。ストレージに余裕があれば、現在のComposeファイル、環境変数、マウントパス、イメージバージョン、直近のログ、破損したデータベースの状態を保存してください。障害が起きたデータベースにも原因を解明する手がかりが残っていることがあります。上書きすると、その証拠が失われます。

信頼するバックアップを正確に特定してください。タイムスタンプ、作成方法、ファイルサイズ、テスト復元の実施有無を記録します。データベースが生成したSQLダンプと、稼働中のPostgreSQLデータディレクトリの生コピーは別の復旧用データです。互換性があるものとして扱わないでください。

可能な限り、復旧先は別のディレクトリまたは分離したスタックに作成してください。この段階の完了条件は簡単です。障害発生時の元の状態が保持され、選択したバックアップが読み取り専用になっていて、復元後に再接続するデプロイバージョンとストレージパスが分かっていることです。

バックアップから実際に復元できることを確認する

リプレイする前に、バックアップを確認してください。圧縮されたSQLダンプは問題なく解凍でき、失敗したパイプラインによって生成された空のアーカイブではなく、PostgreSQLダンプと分かる内容が含まれている必要があります。チェックサムやリポジトリの検証結果がある場合は、復旧の途中で破損が発覚する前に、今すぐ照合してください。

PostgreSQLのダンプは、データベースを意識したツールで作成され、クリーンなターゲットに読み込めるため、稼働中のデータベースディレクトリを気軽にコピーするより安全な復旧用データです。データベースダンプによるバックアップ方式なら、データベースとメディアのコピーも分けられるため、復旧前にそれぞれを検証しやすくなります。

また、バックアップ時点のメディアと設定が残っていることも確認してください。データベースだけを復元すると、ユーザー、アルバム、メタデータ、ファイル参照は復旧できても、参照先のライブラリパスが見つからず、すべてのアセットが利用できなくなる可能性があります。ダンプとメディア/設定一式が、特定できている同じ復旧ポイントのものである場合にのみ進めてください。

互換性のあるクリーンなデータベースターゲットを先に起動する

バックアップを作成したバージョンに合った復元方法を選んでください。現在のImmichリリースでは、Administration > Maintenanceおよび新規インストール時のオンボーディング手順からデータベースを復元できますが、古いバックアップではバージョン固有の手動手順が必要になる場合があります。復元ワークフローはv2.5.0で変更されました。

新しい復旧先では、データベースの復元準備が整う前に、Immichが空のスキーマに対して通常のマイグレーションを実行しないようにしてください。PostgreSQLとアプリケーションを一緒に起動するデプロイ方法の場合は、バージョンに適した復元制御を使用し、インポート前にサーバーが競合する状態を作らないようにしてください。

データベースが自力で正常な状態にならない場合は、まず停止して問題を解決してください。再起動を繰り返している、ディスク容量が不足している、または互換性のないストレージ構成を使っているターゲットに、同じバックアップを何度も読み込ませないでください。クリーンで安定したターゲットを用意することが前提であり、トラブルシューティングのついでではありません。

ダンプを一度だけ復元し、最初のエラーで停止する

選択したダンプを準備済みのデータベースに復元し、出力全体を記録します。ダンプ形式に適したデータベースツールとフラグを使用し、エラーが発生した場合に復元が明確に失敗するようにしてください。部分的にインポートされたスキーマが起動してしまう事態を避けられます。

使用可能な移行セットには、アセット、PostgreSQLの状態、それらを再接続する設定が必要です。完全なImmichバックアップセットには、アップロード済みアセット、サポートされているデータベースのバックアップ、デプロイ設定が含まれ、復元テストによってセットが機能することを確認します。復旧時点に合わせて復元先を特定できるよう、これらをまとめて保管してください。

インポートが成功したら、Immichアプリケーションを起動し、初回起動時の動作を注意深く確認します。既存のアカウントを受け付けず、新しい最初の管理者アカウントの作成を求められた場合は、作業を中断してください。復元したデータベースがImmichで使用されていない可能性が高いことを示しています。その空の状態に写真を再アップロードし始めないでください。

データベースの状態、メディアのパス、新しい書き込みを検証する

既存のアカウントでログインし、過去と最近の日付を含めてタイムラインを確認します。いくつかのオリジナル画像を開き、存在していたことが確かなアルバムやお気に入りを確認して、データベースのレコードが表示されるだけでなく、アプリケーションが実際のファイルを参照できていることを確認してください。

復元時には、データベースの状態、アプリケーションファイル、設定、アップロードデータの整合性が取れている必要があります。PostgreSQLが起動するかどうかだけでなく、整合性の取れたデータベースコンテナのバックアップを受け入れ基準にしてください。

最後に、使い捨て用の写真を1枚アップロードし、通常どおり処理されるまで待ちます。Immichの再起動後もホストの再起動後も写真が残っていることを確認してから、アプリケーション上で削除します。アカウント、既存のアセット、新しい書き込みがすべて正常に動作する場合は、バージョンアップ前に復旧後の状態のバックアップを新たに作成してください。正常に動作しない場合は、問題を悪化させるのではなく、保存しておいた障害の証拠または以前の正常なバックアップに戻してください。

サポートとヒント

続きを読む

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.