Immichはアップグレードに支障なく外部データベースを使用できますか?

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

Immichの接続先を外部のPostgreSQLサービスにすることはできますが、それによってアップグレードが自動的に安全になるわけではありません。データベースのバージョン、拡張機能、権限、バックアップ、ロールバックに関する責任が、デフォルトの構成の外部に移るということです。

外部データベースは、パフォーマンスを確認するためのチェック項目ではなく、高度な互換性上の境界として扱ってください。ImmichまたはPostgreSQLをアップグレードするたびに、実行予定のImmichの正確なリリースの要件を確認し、外部サーバーが必要な拡張機能と権限を提供できることを確かめ、復元可能なバックアップを作成してください。また、どのコンポーネントが障害の原因になったかを特定できるよう、アップグレードの各レイヤーを一度に1つずつ変更してください。

まず外部データベースの利用条件を確認する

データベースのエンドポイント、データベース名、サービスアカウント、TLSモード、PostgreSQLのメジャーバージョン、インストール済みの拡張機能名とバージョン、およびそれらの拡張機能をアップグレードできる担当者を記録してください。コンテナの再作成時に別のサーバーやデータベースへ意図せず再接続されないよう、この記録をImmichのデプロイ定義と一緒に保管してください。

既存のPostgreSQLサーバーを使用することはできますが、Immichが推奨するデフォルトの構成ではありません。現在のリリースでは、スタンドアロンデータベースを使用する場合、pgvectorとVectorChordが必要です。ImmichはPostgreSQL 14から19、pgvector >=0.7かつ<0.9、VectorChord >=0.3かつ<2.0での動作が確認されています。これらの範囲は変更される可能性があるため、アップグレードのたびに再確認してください。

切り替え前に権限を計画してください。Immichでは通常、スーパーユーザー権限を持つデータベースロールが必要です。権限なしで実行する方法は上級者向けで、アップデート時に手動での対応が必要になる場合があります。また、現在の自動データベースバックアップにはスーパーユーザー権限が必要です。外部プロバイダーがこれらの要件を満たせない場合は、本番環境のデータを移行する前に作業を中止してください。

変更を加える前にPostgreSQLと拡張機能の互換性を確認する

現在と移行先のPostgreSQLバージョン、およびImmichが依存するすべての拡張機能を一覧にしてください。PostgreSQLのメジャーバージョンアップグレードでは、移行先のメジャーバージョン向けにビルドされた拡張機能のバイナリが必要になることがあります。一方、Immichのアップグレードでは、PostgreSQL自体が起動し続けても、新しい拡張機能やマイグレーションの挙動が必要になることがあります。

拡張機能のパッケージファイルとSQL上の拡張機能の状態は、PostgreSQLのアップグレードに伴って引き継がれると考えず、データベースとともに慎重に移行する必要があります。データベースのメジャーバージョンやImmichが必要とする拡張機能のパッケージを変更する前に、PostgreSQL拡張機能のアップグレードに関する依存関係を確認してください。

外部プロバイダーで必要な拡張機能をインストールまたはアップグレードできない場合、必要に応じて共有プリロード設定を変更できない場合、またはマイグレーションに必要な権限を付与できない場合は、Immichの更新前に作業を中止してください。通常のクエリを受け付けるデータベースでも、次のアプリケーションのマイグレーションに適しているとは限りません。

データベースのメジャーバージョンアップグレードとImmichのアップグレードは分けて行う

一連の手順全体をすでにリハーサルしている場合を除き、PostgreSQLのメジャーアップグレード、拡張機能のアップグレード、Immichアプリケーションのアップグレードを1回の保守作業にまとめることは避けてください。複数の互換性の境界を同時に移動すると、起動に失敗しても、どのレイヤーが原因か分からなくなります。

PostgreSQLのマイナーアップデートとメジャーバージョンへのアップグレードは、別々の保守作業です。メジャーアップグレードでは、サードパーティ製拡張機能を含む移行先環境を事前に準備する必要があります。起動に失敗した場合に調査対象の変更を明確に1つにできるよう、可能な限りPostgreSQLのメジャーバージョンへのアップグレードとImmichアプリケーションのアップグレードは分けてください。

ホームサーバーで最もリスクの低い手順は、通常、バックアップを作成し、復元を検証し、1つのレイヤーを更新して、検証を実行してから先に進むことです。Immichのリリースでデータベースの変更が必要な場合は、一般的なPostgreSQLアップグレード手順を適用するのではなく、そのリリースで指定された順序に従ってください。

データベースとメディアの両方を対象とするロールバック経路を確保する

外部データベースを使うと、Immichの状態がPostgreSQLとメディアライブラリに分かれていることを忘れやすくなります。データベース整合性を保つ方法でデータベースをバックアップし、スキーマやアセットのメタデータが変更される可能性のあるマイグレーションの前に、同じ復旧対象期間の関連するメディアと設定の状態も保全してください。

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

アプリケーションのマイグレーションが一部だけ成功した場合に、両方の側で何が起きるかを把握するまでは、ロールバックの準備ができたと判断しないでください。既知の正常なコピーに新しい状態を書き重ねることなく復旧できるよう、以前のアプリケーションバージョン、デプロイ定義、データベースバックアップ、メディアの状態を十分な期間保持してください。

データベース接続だけでなく、アプリケーションとしてアップグレードを検証する

変更後、PostgreSQLがImmich用の想定されたロールを受け入れること、必要な拡張機能が想定どおりのバージョンで存在すること、Immichのマイグレーションがデータベースエラーを繰り返すことなく完了することを確認してください。TCP接続の成功や `SELECT 1` は接続性を証明するだけで、アプリケーションとの互換性を証明するものではありません。

その後、通常どおりImmichを使います。以前のアルバムを読み込み、代表的な写真や動画を開き、検索し、該当する場合はユーザーや共有を確認して、使い捨てのアセットを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.