Implementación de Repovio

Guía de implementación de producción, proxy TLS, copia de seguridad, restauración, actualización y reversión para Repovio.

La pila Compose de Repovio inicia PostgreSQL, aplica las migraciones de Prisma una vez y luego inicia la API y las aplicaciones web. No finaliza TLS. Coloque los servicios web y API detrás de un proxy inverso que posea el nombre de host público y los certificados.

Requisitos previos

Motor Docker con Docker Compose v2.
Un registro DNS para el nombre de host público.
Un proxy inverso que obtiene y renueva certificados TLS.
Un directorio de servidor privado legible solo por los administradores de implementación.

La pila Compose conserva los datos PostgreSQL, incluidas las imágenes de perfil de usuario normalizadas, en su volumen denominado repovio-postgres. No elimine este volumen a menos que desee eliminar intencionalmente todos los datos de Repovio.

Primera implementación

Paso 1: consulte una versión publicada de Repovio y cree el archivo de entorno privado:

cp .env.example .env
chmod 600 .env

Paso 2: Reemplace todos los marcadores de posición en `.env`, especialmente `POSTGRES_PASSWORD`, ambas URL de la base de datos, `AUTH_JWT_SECRET` y

TOKEN_ENCRYPTION_KEY. Genere la clave de cifrado con:

openssl rand -base64 32

Paso 3: Establezca las URL visibles externamente. Para una implementación en `https://repovio.example.com`, utilice:

PUBLIC_URL=https://repovio.example.com
OIDC_CALLBACK_URL=https://repovio.example.com/api/v1/auth/oidc/callback
CORS_ORIGIN=https://repovio.example.com
NUXT_PUBLIC_API_BASE_URL=https://repovio.example.com/api/v1
OAUTH_CALLBACK_URL=https://repovio.example.com/api/v1/provider-accounts/oauth/callback

Paso 4: Vincular los puertos del contenedor al loopback cuando el proxy inverso se ejecute en el mismo host:

REPOVIO_API_PORT=127.0.0.1:3001
REPOVIO_WEB_PORT=127.0.0.1:3000

De lo contrario, restrinja el acceso a los puertos 3000 y 3001 con el firewall del host. Nunca exponga el contenedor PostgreSQL.

Paso 5: Configure `REPOVIO_VERSION` en `.env` en un par de imágenes publicadas exactas y luego inicie la pila:

docker compose pull
docker compose up --detach --wait

Mantenga ese valor en .env para que cada comando de redacción posterior utilice la misma API y versión web.

Paso 6: Confirme el punto final de estado de la API localmente:

curl --fail http://127.0.0.1:3001/api/health

Paso 7: Abra la URL pública Repovio y complete el configuración única de primera ejecución para crear el primero

administrador del sistema.

Proxy inverso y TLS

Proporcione el origen web público al puerto 3000 y las rutas API y Socket.IO al puerto 3001. Por ejemplo, un bloque de sitio Caddy puede usar:

repovio.example.com {
  reverse_proxy /api/* 127.0.0.1:3001
  reverse_proxy /socket.io/* 127.0.0.1:3001
  reverse_proxy /mcp 127.0.0.1:3001
  reverse_proxy 127.0.0.1:3000
}

El proxy debe redirigir HTTP a HTTPS, validar las conexiones ascendentes de acuerdo con su política local y preservar el nombre de host público. Configure los proveedores OAuth con la misma URL de devolución de llamada HTTPS configurada en OAUTH_CALLBACK_URL.

Actualización

Migrar una instalación anterior

Siga el actualización de marca antes de iniciar la pila renombrada. Configure REPOVIO_POSTGRES_VOLUME con el nombre exacto del volumen existente. Preservar las credenciales de la base de datos y la clave de cifrado; no se requiere ninguna copia o restablecimiento de la base de datos para la marca.

Paso 1: Cree y verifique una copia de seguridad de la base de datos antes de cambiar las imágenes.

Paso 2: Configure `REPOVIO_VERSION` en la versión de lanzamiento exacta en `.env`.

Paso 3: Tire y aplique el liberador:

docker compose pull
docker compose up --detach --wait

El servicio migrate se aplica a las migraciones de Prisma pendientes antes de que se inicie la API. Inspeccionarlo después de cada actualización:

docker compose logs migrate

Paso 4: Verifique el punto final de estado y el panel de control servido por proxy antes de considerar que la actualización se ha completado.

Copia de seguridad de la base de datos

Ejecute copias de seguridad desde el directorio de implementación. Esto escribe un volcado de formato personalizado PostgreSQL en el host sin imprimir las credenciales ni colocarlas en la línea de comando:

mkdir -p backups
backup_file="backups/repovio-$(date +%F-%H%M%S).dump"
docker compose exec -T postgres sh -c 'pg_dump -U "$POSTGRES_USER" -Fc "$POSTGRES_DB"' \
  > "$backup_file"
pg_restore --list "$backup_file"

Almacene copias cifradas fuera del host y pruebe periódicamente las restauraciones en un sistema separado.

Restauración de base de datos

La restauración reemplaza los objetos de la base de datos actual. Primero realice una nueva copia de seguridad y programe un tiempo de inactividad.

docker compose stop api web
docker compose exec -T postgres sh -c 'pg_restore -U "$POSTGRES_USER" --clean --if-exists --no-owner -d "$POSTGRES_DB"' \
  < backups/repovio-YYYY-MM-DD-HHMMSS.dump
docker compose up --detach --wait

Luego, verifique docker compose logs migrate y el punto final de estado de la API. Restaure un volcado realizado por una versión compatible de Repovio al revertir cambios de esquema.

Paso 4: Si la versión más reciente migró la base de datos de manera incompatible, detenga la API y la web, restaure la copia de seguridad compatible y luego

inicie nuevamente la versión de la imagen anterior.

Nunca utilice docker compose down --volumes como comando de actualización o reversión: elimina el volumen denominado PostgreSQL.

Editar esta página

Buscar documentación…

Actualización de marca