互換性のないリリース後にImmichを安全にロールバックする方法

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

現在の状態を保全し、新しいリリースで旧イメージが読み取れない形にデータベースや設定が変更されたかどうかを確認してから、Immichをロールバックしてください。

コンテナイメージは差し替えられますが、その永続データはすでにマイグレーションされている可能性があります。アップグレードがうまくいかない場合は、自動更新と新しい書き込みを停止し、両方のバージョンを記録して、現在のデータベースとメディアを保護したうえで、単純なイメージのロールバックにするか、アップグレード前の復旧ポイントを復元するかを選んでください。

失敗したアップグレードがさらに状態を変更する前に停止する

証拠を集めている間、自動イメージ更新を無効にし、クライアントから新しい写真が追加されないようにしてください。旧版と新版のImmichイメージのバージョンまたはダイジェスト、PostgreSQLのバージョン、Composeファイルと環境ファイル、マウントパス、最初に発生した起動時またはマイグレーション時のエラーを記録してください。

ZimaSpaceのコンテナのロールバック境界に関するガイドでは、重要な違いが説明されています。永続ボリュームはイメージを差し替えても残りますが、それが安全なのは、旧バージョンのアプリケーションがボリューム内の状態と引き続き互換性を保つ場合に限られます。

データベースを読み取れる場合は、現在の障害状態をデータベース固有の方法でバックアップし、アップグレード前のバックアップは別に保管してください。繰り返し試行して、どちらかを上書きしないでください。直ちに旧バージョンへ戻すことが目的でも、今後、復旧を進める際に現在のコピーが必要になる場合があります。

リリースがデータベースのマイグレーション境界を越えたかどうかを確認する

アップグレード後に最初に発生した障害を確認し、データベースのマイグレーション前または実行中に起きたのか、マイグレーション後のアプリケーション起動時に起きたのか、ユーザーの操作時にのみ起きたのかを特定してください。このタイミングによってロールバック計画は変わります。新しいリリースですでに変更されたスキーマを、古いイメージが認識できない場合があるためです。

サービスがアップグレードの過程で失敗した最近のImmichの報告は、サポートされていない、または一部を飛ばしたマイグレーション経路では、単純なバージョンの差し替えがうまくいかないことを示しています。このスレッドを事例として参考にし、使用しているバージョンに応じた正確なマイグレーション順序を確認してください。

新しいアプリケーションがデータベースに一切触れておらず、イメージまたはランタイムの互換性だけが問題なら、イメージを指定バージョンに戻すだけで十分な場合があります。マイグレーションが完了している場合は、互換性を示す明確な根拠がない限り、旧イメージにはアップグレード前のデータベースバックアップを組み合わせるほうが安全だと考えてください。

時期の異なるデータベースとランタイムを混在させず、一致する組み合わせに戻す

最後に正常動作したアプリケーションのバージョン、それに互換性のあるデプロイ設定、互換性のない変更が加わる前のデータベース復旧ポイントを使って、ロールバック先を構築します。リリースでメディアファイルが変更されたことが文書に明記されていない限り、メディアツリーはそのまま維持してください。アプリケーションイメージが変わっただけで、数テラバイトものデータを再コピーする必要はありません。

データベース互換のあるロールバック計画に関するデータベースのロールバックの説明では、古いコードを、そのコードが理解できなくなったスキーマに対してデプロイする一般的な危険性を解説しています。コンテナ自体が正常に起動するかどうかにかかわらず、この原則は重要です。

検証が終わるまで、モバイルクライアントとスケジュール済みジョブが書き込みできないよう、ロールバックしたインスタンスを隔離して起動してください。旧バージョンがすぐにスキーマエラーを報告した場合は、停止してください。テスト済みのバージョン固有の復旧手順がない限り、唯一のデータベースコピーに対して手動で移行を巻き戻さないでください。

正常動作が確認されたイメージを正確に固定し、その設定を再現する

変動するタグではなく、特定のバージョンまたは不変のイメージ参照を使用してください。最後に正常動作が確認されたデプロイメントの環境、サービス依存関係、デバイスマッピング、ネットワーク、ポート、リバースプロキシの転送先を復元します。複数のインフラ層が気づかないうちに変更されるロールバックは、二次障害を引き起こします。

失敗した新しいイメージと設定は、ロールバックの記録と一緒に保管してください。互換性の問題を把握した後で、計画的に前方復旧を行えます。新しい成果物をすべてすぐに削除すると、失敗した状態と正常に動作する状態を比較したり、テスト環境でアップグレードを再現したりするのが難しくなる場合があります。

復元した状態で旧バージョンのサービスが起動した場合は、クライアントを有効にする前にログを確認してください。予期しない移行の試行、新規インストールの初期化、ストレージマウントの欠落、権限の書き換えがないことを確認します。ログインページが表示されただけでは、ロールバックで意図したデータが使われている証拠にはなりません。

元のトリガー条件で旧バージョンを検証し、次へ進む手段を確保する

代表的なユーザー、古いアセットと最近のアセット、アルバム、共有、検索、管理下で行う新規アップロード1件、バックグラウンドジョブ、データベースバックアップの作成、リバースプロキシのルートをテストしてください。スタックを一度再起動し、手動で介入しなくても同じマウントとデータベースが復帰することを確認してください。

これらのチェックに合格するまで、新しいアップロードを一時停止してください。その後、アクセスを再開し、通常のワークロード時間帯を監視します。アップグレード前のバックアップと、新しいバージョンでの失敗状態のバックアップの両方を保管してください。互換性の問題が判明した後、隔離したコピーでアップグレードを再試行できます。

以前のバージョンでスキーマの互換性がないと報告される、既知のデータが見つからない、または想定外のパスに書き込みが行われる場合、ロールバックは失敗しています。修復を重ねるのではなく、作業を中止し、保存しておいたリカバリポイントを再度復元してください。正確なバージョン、移行ログ、データベースバックアップのタイムスタンプ、Composeの差分、最初に失敗した検証手順を添えてエスカレーションしてください。

サポートとヒント

続きを読む

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.