Skip to content

Backup e restauração

O central tem um só portador de estado — PostgreSQL. Ou seja, todo o backup da instalação é um dump regular de um banco; nem os diretórios de estado dos streamers nem o arquivo entram nele, e nenhum é preciso para restaurar o plano de controle.

Tire dumps

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

As credenciais estão no DATABASE_URL de /etc/optic/secrets.env. Ponha num timer e leve as cópias para fora da máquina: o dump é pequeno (configuração e registros, não mídia), tirá-lo até de hora em hora não custa nada.

Guarde o próprio arquivo /etc/optic/secrets.env uma vez, na instalação: ele não está no dump, e uma instalação restaurada precisará das mesmas senhas.

Restauração

Procedimento de restauração:

  1. Pare todas as instâncias do central: execute systemctl stop optic em cada máquina de gestão.
  2. Recrie o banco e carregue o dump. No exemplo, o papel optic deve ser proprietário do banco e ter o privilégio 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. Inicie o central com central.components.migrate: true: systemctl start optic. Aguarde até que esteja pronto e inicie as demais instâncias.

Nada mais é preciso: os streams, o registro e as configurações voltaram com o dump, e os streamers — que todo esse tempo transmitiram por conta própria — reconectam automaticamente, dentro da pausa de repetição de um minuto. Se o dump for mais velho do que o que os streamers chegaram a aplicar, eles recebem do central um sinal explícito e tomam o estado dele como a verdade — o retorno a versões anteriores não interrompe o cluster.

Destruição completa do central — a transmissão não para

Esta é a garantia principal da arquitetura do Optic: a perda de toda a máquina do central — disco, banco, tudo — não interrompe a transmissão. Os streamers funcionam de forma autônoma, e a reprodução continua durante a restauração do central.

  1. Instale o Optic numa máquina nova sem entrar no console.
  2. Devolva o /etc/optic/secrets.env guardado (ou escreva o DATABASE_URL antigo no novo, se o banco era externo e sobreviveu).
  3. Restaure o banco do dump como acima e inicie o serviço.

Os streamers encontram o novo central no endereço anterior e se reconectam: suas chaves foram restauradas do dump com o registro. O plano de controle foi restaurado e a transmissão continuou sem interrupções.

Se não há dump — o plano de controle se constrói de novo: um central vazio, streams criados do zero, e cada streamer órfão é reengatado com reset de estado e token novo. A transmissão continua também nesse cenário — mas a configuração de streams terá que ser refeita à mão. Um pg_dump regular poupa você do rebalanceamento do cluster inteiro.

O que não precisa de backup

  • Diretórios de estado dos streamers — identificam cada máquina; após a perda de uma máquina, faça a adesão da substituta ao grupo.
  • Arquivo DVR — mídia nos discos dos streamers; sua proteção depende dos discos e da replicação, não de um dump do banco.
  • Armazenamento de métricas — fica na memória; o histórico volta a se acumular.