Composeファイル、環境変数の値、データベース、アップロードライブラリ、外部ライブラリのマウント定義を、それぞれ個別の永続資産として扱い、まとめて取得・復元することで、アップグレード時のImmich設定の消失を防いでください。
コンテナは置き換えられますが、その周辺の設定はそうではありません。相対パスのバインドマウントが別のプロジェクトディレクトリを基準に解決されたり、環境変数の編集が再作成後のコンテナに反映されなかったり、新しいスタックが空のデータベースに接続したりすると、アップグレードによってImmichのデータが消えたように見えることがあります。まず稼働中のデプロイメントを一覧化し、バージョン管理されたコピーをホスト外に保管して、本番環境への切り替え前に計画的な再作成を検証してください。
アップグレードのたびに稼働中のデプロイメントを記録する
シークレットを伏せた有効なCompose設定をエクスポートし、イメージのバージョンまたはダイジェストを記録して、Composeファイルと環境変数ファイルをバージョン管理されたストレージにコピーしてください。エディター内のファイルで現在のコンテナを起動したと思い込まず、実行中のマウントを確認します。合格条件は、各実行時パスが既知のホスト上の場所に対応していることです。
外部ライブラリのパス、リバースプロキシの設定、機械学習サーバーのURL、データベース接続値、ユーザーとグループの識別情報、ネットワーク名、ハードウェアアクセラレーションデバイスを記録してください。ここで項目が抜けていると、後でアップグレード後の差異の原因がわからなくなります。
コミュニティのアップグレードに関する質問では、どのCompose世代や環境変数の構成が適用されるのか、運用担当者が把握できなくなるケースが繰り返し見られます。アップグレード設定に関する議論から得られる有益な教訓は、現在正常に動作している定義を翻訳する前に保存しておくことです。
データベース、メディア、デプロイメントファイルを個別にバックアップする
データベース固有のバックアップに加え、アップロードライブラリとデプロイメントディレクトリのファイルシステムバックアップまたはスナップショットを取得してください。開始時刻と完了時刻、アーカイブサイズ、チェックサムを記録します。Compose YAMLだけではコンテナを再構築できますが、アカウント、メタデータ、アルバム、アセットのレコードは復元できません。
一貫性を保つ最も簡単な方法は、バックアップ中にサービスを停止することです。稼働中に行う場合は、データベースのダンプとストレージのスナップショットを連携させ、両者の関係を記録してください。外部ライブラリのオリジナルをImmichが管理していない場合でも、パスやアクセスルールは復元後のサービスに影響するため、インベントリに含めてください。
コミュニティがメンテナンスするメジャーバージョンアップグレード手順では、データベース、メディア、Compose、環境変数を保持することが重視されています。記載された手順は運用者の経験に基づくものとして扱い、実際にデプロイするリリースに照らして各手順を確認してください。
バージョンを固定してアップグレードをステージングする
スキップしたすべてのバージョンのリリースノートを読み、保存済みのデプロイ定義を慎重に更新してください。移行先のリリースを固定し、古いイメージを削除せずにプルして、レンダリング後のCompose設定を検証してください。不明な変数、空のマウント、サービスのバージョン混在があれば、ステージングの判定基準を満たしません。
容量に余裕があれば、ポートを変え、本番環境への書き込みアクセスを無効にした分離テストスタックにバックアップを復元してください。移行先のバージョンで起動し、マイグレーション、ユーザー、ストレージパス、バックグラウンドジョブを確認してください。コンテナが正常に起動しただけでは、元のライブラリが接続されている証拠にはなりません。
関連するZimaSpaceのセルフホストNASの安全な運用ガイドでは、アップグレードによって影響を受ける可能性のある単一ホストと認証情報の境界の外に、デプロイファイルとバックアップを配置する方法を解説しています。
再作成後の設定永続性を検証する
切り替え前に、テスト用コンテナをその場で再起動するのではなく、保存したファイルから再作成してください。ユーザー、サーバー設定、ストレージテンプレート、ライブラリ、ジョブ、プロキシアクセス、有効な環境変数を検証してください。設定が文書化された永続コンポーネントに保存され、コンテナを置き換えても維持されることを合格条件とします。
本番環境への切り替え後、テスト用アセットを1つアップロードし、検索を実行して、オリジナルを開き、新しいデータベースバックアップを作成してください。スタックとホストを再起動してから、同じ手順をもう一度実行してください。通常のワークロードが観察期間を通じて安定するまで、旧バージョン、バックアップ、デプロイ定義を保持してください。
アップグレードによってすでに空の状態で起動してしまった場合は、初回設定や新規アップロードによって状態の不整合が発生する前に停止してください。検証済みの永続パスのみを再接続するか、空の移行先に復元してください。想定されるユーザーやアセットが見当たらない場合はロールバックしてください。識別情報が依然として曖昧な場合は、機密情報を除去した有効な Compose 設定、マウント、バージョン、バックアップのタイムスタンプを添えてエスカレーションしてください。
サポートとヒント
続きを読む

家族に見られないように、NAS上のアダルト動画を隠す方法
家族で使うNASでは、アダルト動画を非公開に保ちましょう。フォルダーのアクセス権、PlexとJellyfinのライブラリーへのアクセス、サムネイル、視聴履歴、共有テレビのログイン情報、DLNAを確認してください。

Transformersでコミュニティモデルを読み込む前に確認すべきこと
TransformersのJinjaサンドボックスアップデートを使って、モデルの来歴、チャットテンプレート、リモートコード、シリアライズされた重み、隔離された初回実行を確認しましょう。

Mirageをローカルで実行:1枚の画像から文字認識と物体検出
Cactus Computeの小型ローカルビジョンモデルを試し、実際の入力でOCRとオブジェクト抽出を検証して、メモリ、言語、プライバシーの制限を把握しましょう。



