Pular para o conteúdo

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.

CaminhoUse paraPrecisa deGuia
k3d localExperimentar. Um cluster Kubernetes real e descartável no seu laptop, ~1,2 a 1,5 GiB de RAM.Docker, k3d, kubectl, helmlocal-k3d.md
Docker ComposeHost único, sem Kubernetes. O jeito mais rápido de ter a stack no ar, ou um smoke test de CI.Docker Engine + Compose v2docker-compose.md
HelmQualquer cluster real, staging ou produção.Kubernetes 1.30+, Helm 3.xhelm.md
kubectl puroTimes que não podem ou não rodam Helm.Kubernetes 1.30+, kubectlkubectl.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á; veja security.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.md antes de improvisar. As três primeiras entradas dele são modos de falha já encontrados nestes caminhos de instalação.