Docker, serviços e ambientes

Você vai aprender: separar a infraestrutura necessária à aplicação da documentação que pode ser lida sem iniciá-la.

Container não é o sistema inteiro

O Compose organiza serviços como PostgreSQL, Mosquitto, Grafana e aplicações Node. Eles têm processos, configurações e armazenamento próprios. Reiniciar um componente pode afetar o fluxo mesmo quando outro continua saudável.

Uma imagem contém o programa e suas dependências. Um container é uma execução dessa imagem. Um volume conserva dados fora do ciclo de vida do container. Apagar volumes pode apagar histórico.

Profiles não são botões de desligar

O projeto separa seleção por profiles: hardware para coleta real, simulation para simulador e admin para administração. Omitir um profile em uma invocação não desliga um container criado anteriormente.

Por isso é perigoso concluir “não selecionei hardware, então nenhum coletor real está rodando”. É necessário observar o estado real antes de alterar a stack.

Quatro ambientes distintos

Ambiente	O que sabemos
Documentação	VitePress gera HTML a partir de docs/manual/; não consulta a usina
Teste em memória	Dependências falsas podem verificar lógica sem rede
Integração local	Pode escrever em banco e publicar no broker configurado
Produção	Depende de configuração e deploy manual no servidor do campus

“Local” não significa automaticamente isolado. Uma configuração local pode apontar para serviços reais.

Leitura antes de execução

Antes de iniciar ou alterar serviços, confira alvo, credenciais, backup quando aplicável e autorização. Ler a documentação e testar lógica em memória não exige iniciar Docker.

Veja como os serviços participam do caminho da medição e confira o escopo do sistema.

Revisão editorial: 07/10/2026. Fontes: docker-compose.yml, docker-compose.prod.yml e regras do repositório.