Instalação
Instalação: visão geral
Quatro caminhos para os mesmos quatro contêineres (web, orbit-api, nocturne,
orbit-stack). Todos os quatro obedecem ao CONTRACT.md: as mesmas
portas, os mesmos nomes de variáveis de ambiente, os mesmos /healthz//readyz, o mesmo
hardening. Escolha um; não misture dois no mesmo host.
| Caminho | Use para | Precisa de | Guia |
|---|---|---|---|
| k3d local | Experimentar. Um cluster Kubernetes real e descartável no seu laptop, ~1,2 a 1,5 GiB de RAM. | Docker, k3d, kubectl, helm | local-k3d.md |
| Docker Compose | Host único, sem Kubernetes. O jeito mais rápido de ter a stack no ar, ou um smoke test de CI. | Docker Engine + Compose v2 | docker-compose.md |
| Helm | Qualquer cluster real, staging ou produção. | Kubernetes 1.30+, Helm 3.x | helm.md |
kubectl puro | Times que não podem ou não rodam Helm. | Kubernetes 1.30+, kubectl | kubectl.md |
Se você não tem certeza de qual escolher
- Você tem Docker e mais nada →
docker-compose.md. - Você quer ver o hardening do Kubernetes (NetworkPolicy, PDB, topology spread)
fazendo alguma coisa, em um laptop →
local-k3d.md. (O k3s impõe as NetworkPolicies pelo controlador kube-router que ele embute, então as políticas também fazem efeito lá; vejasecurity.md.) - Você vai instalar em um cluster que já opera, e Helm é permitido →
helm.md. Este é o caminho de produção; é o único com uma história de rollback que sobrevive a uma tag de imagem ser reapontada. - Você vai instalar em um cluster que já opera, e Helm não é permitido →
kubectl.md.
Antes de qualquer um deles
Todo caminho precisa de credenciais que você mesmo gera; nada neste repositório entrega
uma pronta. Leia configuration.md → "Gerando um token estático"
uma vez, antes de abrir qualquer página de instalação; cada página diz exatamente onde o
token entra naquele caminho, mas nenhuma delas gera o token para você.
Depois que estiver no ar
- Confirme que está saudável, não apenas rodando: execute a seção "Verifique" da página que você seguiu.
- O que observar depois que estiver rodando:
operations.md. - Primeira falha: leia o
troubleshooting.mdantes de improvisar. As três primeiras entradas dele são modos de falha já encontrados nestes caminhos de instalação.