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:
- Pare todas as instâncias do central: execute
systemctl stop opticem cada máquina de gestão. - Recrie o banco e carregue o dump. No exemplo, o papel
opticdeve ser proprietário do banco e ter o privilégioCREATEDB:
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
- 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.
- Instale o Optic numa máquina nova sem entrar no console.
- Devolva o
/etc/optic/secrets.envguardado (ou escreva oDATABASE_URLantigo no novo, se o banco era externo e sobreviveu). - 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.