コンテナのアップデートに失敗した後にImmichを復元する方法

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

コンテナのアップデートに失敗した後は、現在の証拠を保全し、Immichのすべてのサービスを最後に正常動作していたリリースに固定して、連携の取れたロールバックでスタックを起動できない場合に限り、データを復元してImmichを復旧します。

アップデートでは、アプリケーションコード、データベーススキーマの要件、環境変数、関連サービスのバージョンが一度に変更されることがあります。「latest」を何度もプルしたり、新旧のコンテナを混在させたりすると、復旧の境界が見えにくくなります。作業前にComposeファイル、環境設定、ログ、データベース、アップロード先のパスを保存し、イメージのロールバックと、データベースおよびライブラリ全体の復元のどちらかを選んでください。

失敗した状態を凍結し、更新の境界を特定する

自動再起動を停止し、サーバー、機械学習、データベース、キャッシュの各サービスに使用した正確なイメージまたはダイジェストを記録してください。次にプルする前に、起動ログとデプロイファイルを保存します。何が変わったか特定できれば合格です。特定できなければ、デプロイ履歴またはローカルイメージから以前のバージョンを確認できるまで、復旧をいったん保留してください。

サーバーがデータベースへの接続前、マイグレーション中、それとも起動完了後に終了するのかを確認してください。依存サービスへの接続エラーなら、ネットワーク、認証情報、またはヘルスチェックの修正が必要です。マイグレーションエラーの場合、データベースがすでに変更されている可能性があるため、アプリケーションイメージだけを復元するリスクは高くなります。

バージョンを指定したImmichのアップデートの手順では、リリース境界とデプロイファイルが重要な理由を解説しています。移行内容を確認する際に活用しつつ、ロールバックの判断では自分のログとバックアップを根拠にしてください。

まず、最後に正常動作していたイメージへの完全なロールバックを試す

サービスを1つだけ変更するのではなく、Immichのすべてのアプリケーションイメージを、以前に正常動作していた正確なリリースに固定してください。永続ボリュームには触れずに、影響を受けたコンテナを再作成します。スタックが正常になり、ログにスキーマの非互換性が示されなければ、この変更を最小限に抑えたロールバックは成功です。

古いサーバーが現在のデータベーススキーマに対応できない場合は、そこで止めてください。同じデータベースに対して複数のバージョンを交互に試したり、マイグレーションテーブルを手動で編集したりしないでください。この失敗は、更新によってデータの境界を越えたことを意味します。復旧には、選択したアプリケーションリリースとタイムスタンプが一致するデータベースバックアップを使用する必要があります。

Immich v1.135.3の報告では、更新後に発生した特定のデータベースマイグレーション起動失敗が記録されています。その対象を限定したマイグレーションの例は、最初の致命的なエラーを注意深く読む必要性を示すものであり、別のバージョンでその事例のコマンドをコピーして使う許可ではありません。

ロールバックで復旧できない場合に限り、データベースとメディアを復元する

復元する前に、失敗した状態の安全なコピーを作成するか、ストレージのスナップショットを取得してください。クリーンな復旧先を用意し、データベースのバックアップを復元してから、対応するアップロードライブラリと必要なデプロイ用ファイルを公開します。タイムスタンプを合わせるためだけに、現在の唯一のライブラリを古いコピーで上書きしないでください。

データベースのレコードとアセットファイルは、同じコレクションを示している必要があります。バックアップが最近のアップロードよりも前のものである場合は、新しいファイルを別途保管し、後で照合してください。マイグレーションが完了し、想定したユーザーとアセットが表示され、サンプルのオリジナルが開け、広範囲でファイル欠落エラーが発生しない場合、復元は成功です。

ZimaSpaceのImmichマイグレーションガイドは、コンテナイメージ自体をフォトライブラリとみなさずに、永続化するコンポーネントを移行するための有用なチェックリストです。

更新を再試行する前に復旧を検証する

ログイン、タイムラインの閲覧、オリジナルのダウンロード、サムネイルの生成、スマート検索、顔の処理、新しいファイルのアップロード1件、データベースのバックアップ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.