Actualización y migración: Actualización del contenedor

Ámbito: DiscVault v26 estable · DiscVault v26 betaDocker · Unraid≥ DiscVault v26helmerzNL/DiscVault · helmerzNL/DiscVault.EU2026-07-15

Objetivo y resultado

Completa el flujo específico de la página para Actualización y migración: Actualización del contenedor. Este procedimiento utiliza :latest · :beta · :legacy · DISCVAULT_IMAGE · --force-recreate · /update/migration/.

Aplicable a

Esta página se aplica solo a Actualización y migración: Actualización del contenedor (Docker · Unraid). Sus límites de canal y datos son: DiscVault · ghcr.io/helmerznl/discvault:latest; DISCVAULT_IMAGE; PostgreSQL /data · notas de versión y digest inmutable registrado · juego de copias coincidente; DiscVault · ghcr.io/helmerznl/discvault:beta; DISCVAULT_IMAGE; PostgreSQL /data · notas de versión y digest inmutable registrado · juego de copias coincidente. Puntos de control de esta página: :latest · :beta · :legacy · DISCVAULT_IMAGE · --force-recreate · /update/migration/.

DiscVault v26 estable

• DiscVault · ghcr.io/helmerznl/discvault:latest
• DISCVAULT_IMAGE
• PostgreSQL /data · notas de versión y digest inmutable registrado · juego de copias coincidente

DiscVault v26 beta

• DiscVault · ghcr.io/helmerznl/discvault:beta
• DISCVAULT_IMAGE
• PostgreSQL /data · notas de versión y digest inmutable registrado · juego de copias coincidente

Requisitos previos

• juego de copias coincidente
• notas de versión y digest inmutable registrado

Procedimiento

1. Inspecciona: las instalaciones nuevas usan DiscVault v26 :latest o :beta; la imagen congelada :legacy es solo para una instalación existente de la generación anterior que aún no esté lista para migrar
2. Crea una copia: juego de copias coincidente
3. Elige: Solo rama Legacy: después de la copia, cambia únicamente la etiqueta de imagen del despliegue antiguo existente a :legacy, descárgalo y recréalo con la topología intacta, verifica la colección y detente; no cambies ese despliegue existente a la topología v26 en esta página
4. Abre: Actualización y migración: Migración a DiscVault 26 · DiscVault 26
5. Conserva: mantén sin cambios los volúmenes, variables de entorno, puertos y ruta de datos de la generación anterior; nunca sustituyas una imagen de la topología Compose v26 con PostgreSQL por :legacy
6. Verifica: DiscVault v26 · PREVIOUS_IMAGE=@sha256:…
7. Elige: DiscVault v26 · DISCVAULT_IMAGE · :latest :beta
8. Ejecuta: DiscVault v26 · --force-recreate
9. Compara: DiscVault v26 · se ejecuta el digest previsto, la salud es correcta y pasan el acceso del propietario, el recuento y una muestra multimedia

Comandos y ajustes

DiscVault v26 estable

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:latest

DiscVault v26 beta

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:beta

Ambos canales

set -euo pipefail
test -n "$DISCVAULT_IMAGE"
case "$DISCVAULT_IMAGE" in
  ghcr.io/helmerznl/discvault:latest|ghcr.io/helmerznl/discvault:beta) ;;
  *) printf '%s\n' "$DISCVAULT_IMAGE" >&2; exit 64 ;;
esac
cd /opt/discvault
ENV_FILE=/opt/discvault/.env
ENV_TMP="$(mktemp "$ENV_FILE.update.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_TMP" -p discvault -f compose.yaml config --quiet
docker compose --env-file "$ENV_TMP" -p discvault -f compose.yaml pull next-api next-worker next-mcp
docker compose --env-file "$ENV_TMP" -p discvault -f compose.yaml up -d --force-recreate
docker compose --env-file "$ENV_TMP" -p discvault -f compose.yaml ps
curl --fail http://localhost:6080/api/next/health
mv "$ENV_TMP" "$ENV_FILE"
trap - EXIT

Resultado esperado

Acepta el resultado de Actualización y migración: Actualización del contenedor solo cuando se cumplan todos estos resultados: se ejecuta el digest previsto, la salud es correcta y pasan el acceso del propietario, el recuento y una muestra multimedia; mantén sin cambios los volúmenes, variables de entorno, puertos y ruta de datos de la generación anterior; nunca sustituyas una imagen de la topología Compose v26 con PostgreSQL por :legacy. Puntos de control de esta página: :latest · :beta · :legacy · DISCVAULT_IMAGE · --force-recreate · /update/migration/.

• se ejecuta el digest previsto, la salud es correcta y pasan el acceso del propietario, el recuento y una muestra multimedia
• mantén sin cambios los volúmenes, variables de entorno, puertos y ruta de datos de la generación anterior; nunca sustituyas una imagen de la topología Compose v26 con PostgreSQL por :legacy

Seguridad y reversión

Precaución

El límite de recuperación segura de Actualización y migración: Actualización del contenedor exige estas acciones antes de iniciar o continuar: la imagen congelada :legacy no recibe funciones de DiscVault v26, mejoras de migración ni futuras actualizaciones de interfaz; Actualización y migración: Reversión de imagen · juego de copias coincidente; notas de versión y digest inmutable registrado. Puntos de control de esta página: :latest · :beta · :legacy · DISCVAULT_IMAGE · --force-recreate · /update/migration/.

• la imagen congelada :legacy no recibe funciones de DiscVault v26, mejoras de migración ni futuras actualizaciones de interfaz
• Actualización y migración: Reversión de imagen · juego de copias coincidente
• notas de versión y digest inmutable registrado

Siguiente paso

Actualización y migración: Reversión de imagen

Fuente y estado

• helmerzNL/DiscVault@6d27c689ac21
• helmerzNL/DiscVault.EU@583f85c55dc2
• Fuente y estado: 2026-07-15
• DiscVault Docs: 0.1.4