Componentes e confiabilidade¶
Uma instalação do Optic tem poucos componentes, cada um com seu estado armazenado e suas garantias. Esta página descreve o armazenamento do estado, as consequências de falhas e a compatibilidade nas atualizações. O comportamento do cluster durante uma falha do central é descrito separadamente — Autonomia do streamer.
De que a instalação se compõe¶
- O serviço optic na máquina do central — o plano de controle e o streamer local em um só processo.
- PostgreSQL — o armazenamento de estado do central. Guarda a configuração e os registros do grupo.
- Os serviços dos streamers — a transmissão; cada um tem seu diretório de estado e seus discos de arquivo.
- O armazenamento de métricas — integrado, na memória do processo; mantém algumas horas de dados para os gráficos, não um arquivo.
O que é armazenado no PostgreSQL¶
A configuração e os registros da instalação:
- as configurações de streams e as configs dos streamers;
- o registro de streamers — os assentos com a identidade e as chaves das máquinas;
- a alocação de streams, o diário de decisões e as execuções do layouter;
- o diário de sessões fechadas;
- o material TLS do central — a conta ACME e os certificados emitidos.
Um backup do banco permite restaurar a configuração e os registros do grupo. Consulte Backup e restauração.
O que é armazenado em um streamer¶
O diretório de estado /var/lib/optic de cada máquina:
server.ide o cache de ativação — a identidade de licenciamento da máquina;- a identidade do streamer no cluster — a chave com a qual ele se apresenta ao central;
- o cache do slice de configuração aplicado — o que dá a partida a quente sem central;
- o diário local de sessões fechadas até o central colhê-lo.
O arquivo DVR é armazenado separadamente — nos discos dedicados definidos nas configurações do streamer.
O que sobrevive à perda de quê¶
| Perda | O que acontece | O que fazer |
|---|---|---|
| Todas as instâncias acessíveis do central | A transmissão e a gravação continuam; a gestão e a reprodução pelo central ficam indisponíveis | Autonomia do streamer; a conexão é restabelecida automaticamente após o início do processo |
| O banco PostgreSQL | O mesmo, com a perda da configuração | Restaurar de um dump — os streamers se reconectam automaticamente |
| O banco, sem backup | A transmissão continua; os streamers perderam seu registro | Fazer a adesão de cada um novamente: limpar o estado e usar um token novo |
| O diretório de estado de um streamer | A máquina perde sua identidade de licença e de cluster | Fazer a adesão da máquina novamente; os streams serão reatribuídos |
| Um disco DVR | O arquivo desse disco é perdido; a transmissão não é afetada | Os indicadores do disco no diagnóstico |
| O armazenamento de métricas (reinício do processo) | Algumas horas de histórico dos gráficos são perdidas | Nada — os dados voltam a se acumular |
Garantias de compatibilidade¶
- Versões diferentes convivem. O protocolo de troca cresce só por adição: campos desconhecidos devem ser ignorados pelos dois lados, então central e streamers de versões vizinhas trabalham juntos.
- O esquema do banco é compatível numa janela de duas versões. Esquema mais novo sob código mais velho é a norma; isso habilita tanto a atualização por etapas quanto o rollback do binário sem rollback do banco.
- O registro é deliberadamente não idempotente. Aderir de novo a mesma máquina cria um assento novo, e duplicatas por
server_ido registro marca deixando a decisão ao operador.