アップグレードとロールバック

更新中はライブ映像と録画が一時停止します。停止してもよい時間を確保してください。バックアップの範囲と復元方法はバックアップと監視をご覧ください。

アップグレード

1. まずサービスを停止してバックアップを取り、現在のバージョン番号を控えておきます。バージョン番号は 設定 → 一般 → このソフトウェアについて → サードパーティソフトウェア の 1 行目にあります。
2. Rerinku View を停止し、プログラムファイルを置き換えてから起動します。内蔵の FFmpeg と認識コンポーネントは、新しいバージョンに合わせて自動で更新されます。config.yaml は上書きされず、新しい設定項目が自動で追加されることもありません。
3. データベース構造の更新は起動時に自動で行われます。前方向にのみ実行され、各項目は一度だけ実行されます。
4. ヘルスチェック、デバイス数、ライブ映像、過去の録画の再生を確認します。

Docker の更新

Compose ファイルのあるディレクトリで操作します。コンテナーを停止し、/data にマウントしたディレクトリまたは名前付きボリューム全体（設定、データベース、secret.key を含む）をバックアップしてください。ロールバック用に以前のイメージも残します。

docker compose stop
# データボリュームのバックアップ完了後に続行
docker compose pull
docker compose up -d
docker compose logs --tail=100

既存のマウントと設定を引き継いでください。docker compose down -v は名前付きボリュームを削除するため使わないでください。タグを固定している場合は、先に Compose ファイルを公開済みの更新先バージョンに変更します。

更新後の確認

/healthz が 200 を返し、デバイス数が更新前と一致することを確認します。ライブ映像、更新前の録画の再生、更新後の新しい録画を確認してください。AI、リモートストレージ、クイック接続を使っている場合は、認識結果、アップロード、外部ネットワークからのアクセスも確認します。問題があればログを保存し、トラブルシューティングで調べます。

ロールバック

新しいバージョンが起動すると、データベース構造はすでに更新されているため、旧プログラムに戻すだけでは元に戻せません。更新の中には、古いフィールドやテーブルを削除するものもあります。

1. 新しいバージョンを停止し、ログと現在のデータのコピーを残しておきます。
2. アップグレード前のデータベースのバックアップを復元します。録画ディレクトリは通常そのままで構いません。
3. 新しいバージョンを使っていた間に、旧バージョンが認識しない設定項目を設定ファイルに追加していた場合は、先に削除してください。そうしないと、旧バージョンは起動を拒否します。
4. 旧バージョンを起動し、ヘルスチェック、デバイス、録画、再生を確認します。