Visão geral
O operador provisiona e mantém a plataforma por meio de um instalador automatizado e de um processo de deploy baseado em imagens versionadas. O objetivo é subir e atualizar a instalação de forma previsível, com rollback à mão.
Pré-requisitos
- Acesso de infraestrutura (servidor único ou cluster).
- Credenciais do registro de imagens e DNS/TLS do domínio.
Passo a passo
- Provisione a infraestrutura (servidor único ou cluster) com o instalador.
- Configure domínios, DNS e certificados TLS.
- Faça o deploy da imagem versionada da plataforma.
- Rode as migrações de banco e verifique a saúde dos serviços.
- Em atualizações, faça deploy da nova versão com estratégia de atualização gradual.
Configurações & opções
- Variáveis de ambiente: segredos e parâmetros da instalação.
- Imagens versionadas: fixe a versão a implantar (evite tags genéricas em produção).
- Migrações: rode as migrações como etapa controlada do deploy.
Casos de uso
- Subir uma nova instalação do zero.
- Atualizar para uma nova versão com rollback disponível.
Dicas, limites e boas práticas
- Tenha sempre o comando de rollback escrito antes de iniciar o deploy.
- Atualize um serviço por vez e verifique a saúde antes de prosseguir.
- Nunca exponha segredos em arquivos versionados.
Solução de problemas
- Serviço não sobe: verifique variáveis de ambiente e logs do serviço.
- Migração falhou: confira a conectividade do banco e rode a migração isoladamente.