Configuração, Armazenamento e Roteamento

Ingress: Roteamento HTTP/HTTPS por Host e Path

Criar um Service LoadBalancer para cada microsserviço web sairia caro e desperdiçaria IPs públicos. O Ingress resolve isso expondo múltiplos Services internos através de um único Load Balancer na borda do cluster.

O modelo funciona em duas peças: um Ingress Controller (como o NGINX Ingress Controller instalado no cluster) e objetos Ingress (apiVersion: networking.k8s.io/v1) contendo as regras de roteamento por host e path.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: portal-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: mcu.com
    http:
      paths:
      - path: /shield
        pathType: Prefix
        backend:
          service:
            name: svc-shield
            port:
              number: 8080
      - path: /hydra
        pathType: Prefix
        backend:
          service:
            name: svc-hydra
            port:
              number: 8080

Service Discovery & CoreDNS Interno

Para que o serviço checkout converse com o serviço pagamentos, ele não pode depender de IPs fixos. Todo cluster Kubernetes executa um serviço de DNS interno (kube-dns / CoreDNS no Namespace kube-system) que atua como registro central.

• Registro automático: ao criar um Service, seu nome e ClusterIP são gravados no DNS do cluster automaticamente.
• /etc/resolv.conf pré-configurado: todo contêiner nasce apontando para o IP do kube-dns com domínios de busca do próprio Namespace.
• Mesmo Namespace vs. Cross-Namespace: dentro do mesmo Namespace, basta chamar pelo nome curto (ex.: pagamentos). Entre Namespaces diferentes, use o FQDN completo: <service>.<namespace>.svc.cluster.local (ex.: ent.prod.svc.cluster.local).

kubectl get svc kube-dns -n kube-system
kubectl get pods -n kube-system -l k8s-app=kube-dns

Armazenamento Persistente: CSI, StorageClass, PV & PVC

Contêineres são efêmeros: se reiniciam, arquivos gravados na camada local se perdem. O Kubernetes resolve a persistência por meio da CSI (Container Storage Interface) e de uma tríade de objetos:

ConfigMaps: Desacoplando Código de Configuração

Empacotar configurações dentro da imagem Docker obriga você a reconstruir a imagem a cada troca de URL ou porta. Os ConfigMaps armazenam pares chave-valor não sensíveis fora do contêiner e podem ser injetados de três maneiras:

1. Variáveis de ambiente (env / envFrom): simples, porém o Pod não enxerga atualizações sem reiniciar.
2. Comandos de inicialização (args / command): injeta valores na linha de partida do contêiner.
3. Volumes montados (volumes + volumeMounts): monta chaves como arquivos (ex.: /etc/config/app.conf) e propaga atualizações em tempo real para contêineres em execução.

kubectl create configmap testmap1 --from-literal=env=prod --from-literal=port=8080
kubectl get cm testmap1 -o yaml

Secrets: Credenciais, Base64 e Cuidados Reais

Nunca guarde senhas, tokens ou certificados TLS em um ConfigMap. Para dados sensíveis, use Secrets.

kubectl create secret generic creds --from-literal=username=admin --from-literal=password=S3nhaForte
kubectl get secret creds -o yaml

StatefulSets: Identidade Fixa, Headless Service & Storage

Deployments tratam Pods como gado intercambiável (web-7f8b-x9k). Já bancos de dados e sistemas distribuídos (como MongoDB ou Kafka) exigem identidades previsíveis e storage individual persistente. É para isso que existe o StatefulSet:

• Nomes ordenados e estáveis: tkb-sts-0, tkb-sts-1, tkb-sts-2. Se tkb-sts-1 cair, o novo Pod nasce exatamente como tkb-sts-1.
• Criação e encerramento sequenciais: sobe um Pod por vez e espera ficar Ready antes do próximo; na remoção, encerra na ordem inversa respeitando terminationGracePeriodSeconds.
• Headless Service (clusterIP: None): chamado de governing service, não tem IP virtual de balanceamento ("sem cabeça"); o DNS retorna o endereço individual de cada Pod (ex.: tkb-sts-0.mongo-prod.default.svc.cluster.local).
• volumeClaimTemplates: cria automaticamente um PVC exclusivo e "grudento" para cada réplica.