Usando Overlays do Kustomize para Configuração por Ambiente

Coloque o que é compartilhado em uma base. Coloque o que difere em overlays, um por ambiente. O Argo CD detecta o kustomization.yaml no caminho do overlay e roda kustomize build para renderizar os manifests. A base guarda: Deployment, Service, ConfigMap básico, labels comuns. Os overlays fazem patch de: replicas, requests e limits de recursos, tags de imagem, hosts de ingress, valores de ConfigMap específicos do ambiente, variáveis de ambiente e configurações de HPA. Regras principais que eu sigo: 1. Tudo o que difere entre ambientes vive nos overlays, nunca na base. 2. Tags de imagem pertencem aos overlays para que o CI possa dar bump em dev sem tocar em prod. 3. Faça patch com strategic merge ou JSON patches. Não copie o Deployment YAML inteiro em cada overlay; é exatamente essa duplicação que o Kustomize deveria eliminar. 4. Use configMapGenerator com behavior: merge para adicionar ou sobrescrever valores, não substituir o mapa inteiro. 5. Secrets não vão no Kustomize. Use external-secrets, sealed-secrets ou um gerenciador de secrets. Do lado do Argo CD, a Application aponta para o caminho do overlay (apps/web/overlays/prod) e o Argo CD identifica que é Kustomize pelo arquivo kustomization.yaml. Não precisa de configuração extra. Caso de borda: se o mesmo overlay se aplica a dois clusters com uma diferença mínima (um label de região, um sufixo de DNS), não crie um quarto overlay. Use parâmetros de ApplicationSet para passar esse único valor. Do contrário, os overlays se multiplicam rápido.