更新と移行: 復元

目的と結果

このページ専用の手順を実行します: 更新と移行: 復元. この手順で扱う項目: pg_restore --exit-on-error · discvault.failed- · next-worker · next-api.

対象

このページの対象は 更新と移行: 復元 (Docker · Unraid). チャンネルとデータの境界: DiscVault · ghcr.io/helmerznl/discvault:latest; 同じ書き込み停止時間帯の PostgreSQL ダンプとファイルアーカイブ; 以前のイメージを起動する前に、一致するデータを復元する; DiscVault · ghcr.io/helmerznl/discvault:beta; 同じ書き込み停止時間帯の PostgreSQL ダンプとファイルアーカイブ; 以前のイメージを起動する前に、一致するデータを復元する. このページ固有の確認点: pg_restore --exit-on-error · discvault.failed- · next-worker · next-api.

DiscVault v26 安定版

DiscVault · ghcr.io/helmerznl/discvault:latest
同じ書き込み停止時間帯の PostgreSQL ダンプとファイルアーカイブ
以前のイメージを起動する前に、一致するデータを復元する

DiscVault v26 ベータ版

DiscVault · ghcr.io/helmerznl/discvault:beta
同じ書き込み停止時間帯の PostgreSQL ダンプとファイルアーカイブ
以前のイメージを起動する前に、一致するデータを復元する

前提条件

一致するバックアップ一式
メンテナンス時間帯
PREVIOUS_IMAGE · DiscVault ランタイム専用の非公開ファイル

手順

停止: next-api next-worker next-mcp
復元: /data
復元: PostgreSQL · pg_restore --exit-on-error
開始: next-api → GET /api/next/health → next-worker next-mcp

コマンドと設定

両方のチャンネル

set -euo pipefail
BACKUP_ID=20260714T180000Z
cd /opt/discvault
. "/srv/backups/discvault-$BACKUP_ID.env"
test -n "$PREVIOUS_IMAGE"
export DISCVAULT_IMAGE="$PREVIOUS_IMAGE"
docker pull "$DISCVAULT_IMAGE"
ENV_FILE=/opt/discvault/.env
ENV_TMP="$(mktemp "$ENV_FILE.restore.XXXXXX")"
trap 'rm -f "$ENV_TMP"' EXIT
awk -v image="$DISCVAULT_IMAGE" '
  /^DISCVAULT_IMAGE=/ { print "DISCVAULT_IMAGE=" image; found=1; next }
  { print }
  END { if (!found) exit 42 }
' "$ENV_FILE" > "$ENV_TMP"
chmod 0600 "$ENV_TMP"
docker compose --env-file .env -p discvault -f compose.yaml stop next-worker next-mcp next-api
mv /srv/discvault "/srv/discvault.failed-$(date -u +%Y%m%dT%H%M%SZ)"
tar --acls --xattrs -C /srv -xzf \
  "/srv/backups/discvault-data-$BACKUP_ID.tgz"
docker compose --env-file .env -p discvault -f compose.yaml up -d postgres
docker compose --env-file .env -p discvault -f compose.yaml exec -T postgres \
  sh -c 'dropdb --if-exists --force -U "$POSTGRES_USER" "$POSTGRES_DB"'
docker compose --env-file .env -p discvault -f compose.yaml exec -T postgres \
  sh -c 'createdb -U "$POSTGRES_USER" "$POSTGRES_DB"'
docker compose --env-file .env -p discvault -f compose.yaml exec -T postgres \
  sh -c 'pg_restore --exit-on-error --no-owner -U "$POSTGRES_USER" -d "$POSTGRES_DB"' \
  < "/srv/backups/discvault-$BACKUP_ID.dump"
docker compose --env-file .env -p discvault -f compose.yaml up -d --force-recreate next-api
curl --fail http://localhost:6080/api/next/health
docker compose --env-file .env -p discvault -f compose.yaml \
  up -d --force-recreate next-worker next-mcp
docker compose --env-file .env -p discvault -f compose.yaml ps
mv "$ENV_TMP" "$ENV_FILE"
trap - EXIT

期待される結果

次の結果を受け入れる条件: 更新と移行: 復元 以下の結果をすべて確認した場合のみ: ライブラリ件数とメディアのサンプルが選択したバックアップと一致する; :latest :beta. このページ固有の確認点: pg_restore --exit-on-error · discvault.failed- · next-worker · next-api.

ライブラリ件数とメディアのサンプルが選択したバックアップと一致する
:latest :beta