Mapeamento de Serviços — DNS Externo vs DNS Interno K8s

Gerado automaticamente a partir dos IngressRoutes e Middlewares do cluster.

Como a URL interna é montada

O DNS interno segue o formato: http://<service>.<namespace>:<port>/<path>

Regras para encontrar cada parte

<service> e <port> Vem do campo services[].name e services[].port dentro da rota do IngressRoute:

routes:
  - services:
      - name: ms-admin       # → service
        port: 3333           # → port
        namespace: principia-pay

<namespace> Vem do campo services[].namespace na mesma rota. Os IngressRoutes ficam todos no namespace traefik e referenciam explicitamente o namespace de destino.

<path> — ordem de precedência

1. PathPrefix na regra match — forma mais comum, presente na maioria dos serviços:

   Host(`api.provi.com.br`) && PathPrefix(`/admin`)
                                             ↑ usa esse

2. Middleware addPrefix — usado quando o IngressRoute tem um host dedicado (ex: ms-admin.provi.com.br) sem PathPrefix na regra. Nesse caso, buscar o middleware referenciado na rota com nome no padrão add-<svc>-prefix-<path>:

   middlewares:
     - name: add-ms-admin-prefix-admin   # → buscar esse middleware

   O middleware tem o valor real do path:

   spec:
     addPrefix:
       prefix: /admin   # → usa esse

3. Sem path — quando nenhuma das opções acima existe (só middleware de CORS, por exemplo). O serviço responde na raiz /. Casos identificados: infrastructure.principia.services, api.principia.net, boleto.principia.net, api.ies.integracao.principia.net.

Onde buscar no cluster

# Listar IngressRoutes (ficam no namespace traefik)
kubectl get ingressroutes.traefik.io -n traefik

# Ver detalhes de um IngressRoute específico
kubectl get ingressroutes.traefik.io -n traefik <nome> -o yaml

# Listar Middlewares
kubectl get middlewares.traefik.io -n traefik

# Ver o addPrefix de um middleware específico
kubectl get middlewares.traefik.io -n traefik <nome> -o yaml

principia-pay

receita-garantida