Skip to content

Backup y restauración

Central tiene un solo portador de estado — PostgreSQL. Es decir, todo el backup de la instalación es un dump regular de una base; ni los directorios de estado de los streamers ni el archivo entran en él, y ninguno hace falta para restaurar el plano de control.

Tome dumps

pg_dump -U optic optic > optic-$(date +%F).sql

Las credenciales están en DATABASE_URL de /etc/optic/secrets.env. Póngalo en un temporizador y lleve las copias fuera de la máquina: el dump es pequeño (configuración y registros, no medios), tomarlo incluso cada hora no cuesta nada.

Guarde el propio archivo /etc/optic/secrets.env una vez, al instalar: no está en el dump, y una instalación restaurada necesitará las mismas contraseñas.

Restauración

Procedimiento de restauración:

  1. Detenga todas las instancias de central: ejecute systemctl stop optic en cada máquina de gestión.
  2. Vuelva a crear la base y cargue el dump. En el ejemplo, el rol optic debe ser propietario de la base y tener el permiso CREATEDB:
psql -U optic -d postgres -c 'DROP DATABASE optic WITH (FORCE);' -c 'CREATE DATABASE optic OWNER optic;'
psql -U optic -d optic < optic-2026-07-21.sql
  1. Arranque central con central.components.migrate: true: systemctl start optic. Espere a que esté listo y arranque las demás instancias.

No hace falta nada más: los streams, el registro y la configuración volvieron con el dump, y los streamers — que todo este tiempo emitieron por su cuenta — reconectan automáticamente, dentro de la pausa de reintento de un minuto. Si el dump resulta más viejo que lo que los streamers alcanzaron a aplicar, reciben de central una señal explícita y toman su estado como la verdad — el retroceso de versiones no rompe el clúster.

Destrucción completa de central — la emisión no se detiene

Esta es la garantía principal de la arquitectura de Optic: perder toda la máquina de central — disco, base, todo — no interrumpe la emisión. Los streamers funcionan de forma autónoma y la reproducción continúa mientras se restaura central.

  1. Instale Optic en una máquina nueva sin entrar en la consola.
  2. Devuelva el /etc/optic/secrets.env guardado (o escriba el DATABASE_URL anterior en el nuevo, si la base era externa y sobrevivió).
  3. Restaure la base del dump como arriba y arranque el servicio.

Los streamers encuentran el nuevo central en la dirección anterior y se reconectan: sus claves se restauraron del dump junto con el registro. El plano de control se ha restaurado y la emisión continuó sin interrupciones.

Si no hay dump — el plano de control se construye de nuevo: un central vacío, streams creados desde cero, y cada streamer huérfano se reengancha con reinicio de estado y token nuevo. La emisión continúa también en este escenario — pero la configuración de streams habrá que rehacerla a mano. Un pg_dump regular le ahorra el rebalanceo de todo el clúster.

Qué no hay que respaldar

  • Directorios de estado de los streamers — identifican cada máquina; tras perder una máquina, una su sustituta al grupo.
  • Archivo DVR — medios en los discos de los streamers; su protección depende de los discos y la replicación, no de un dump de la base.
  • Almacén de métricas — se mantiene en memoria; el historial se acumula de nuevo.