Kubernetes / Helm

testar rotas do Ingress

Cole YAML já renderizado e confira uma requisição com Host e caminho específicos.

testar rotas do Ingress

YAML ou JSON dos manifestos

Relatório de rota

Cole manifestos ou carregue um exemplo.

Análise local no navegador; sem cluster ou requisição HTTP.

Opções da requisição

Exact e Prefix seguem Kubernetes; regras do controlador não são simuladas.

Limites: 300.000 caracteres, 100 recursos, 500 caminhos.

Cole manifestos ou carregue um exemplo.

Uma regra de Ingress pode casar com o caminho e ainda apontar para uma porta que o Service não expõe. Testar rotas do Ingress ajuda a localizar esse desvio em uma requisição concreta.

O relatório usa apenas os manifestos colados. Ele não acessa o cluster nem envia HTTP, portanto diferencia falha comprovada de informação que depende do ambiente ativo.

Por que testar rotas do Ingress?

Acompanhar a requisição até a porta final

Ao testar rotas do Ingress, a regra de caminho mais longo vence e Exact desempata com Prefix. Em seguida, o relatório mostra como port do Service vira targetPort.

Uma linha azul leva a requisição pela rota escolhida do Ingress ao Service e à carga.

Separar quebra de falta de evidência

Uma porta inexistente no Service é um elo quebrado verificável. Se nenhum Pod foi colado, a carga fica desconhecida; isso não significa que esteja fora do ar.

Uma falha laranja marca a referência quebrada; uma linha pontilhada indica dados de execução desconhecidos.

Três passos de diagnóstico estático

01

Juntar os recursos relevantes

Separe Ingress e Service com --- e acrescente Deployment ou Pod se quiser conferir labels. Um Service homônimo em outro namespace não resolve o backend.

02

Definir a requisição

O caminho padrão é /. Experimente /api/orders e preencha o Host HTTP quando a regra o definir. Host vazio só testa regras sem host.

03

Interpretar o nível de certeza

Correspondência é uma conclusão estática. Quebra aponta referência ausente; incerto indica controle do IngressClass. Depois de editar, execute novamente antes de copiar.

Do host à porta de destino

Comparação de caminhos

Testar rotas do Ingress cobre Exact, Prefix por segmento, Host exato e curinga de um subdomínio. /api não casa com /apix. O roteamento Ingress Kubernetes é avaliado apenas pelas regras padrão.

Mapeamento de duas portas

O backend do Ingress busca a porta ou nome da porta do Service. Só depois o Service aponta para targetPort; se omitido, vale o próprio port.

Contexto opcional de carga

Com Pods ou modelos Deployment, o selector do Service é comparado às labels. Sem esses recursos, nenhum endpoint ativo é presumido.

Limites do relatório local

Comportamento do controlador é incerto
ImplementationSpecific, regex e rewrite variam conforme o controlador. Testar rotas do Ingress sinaliza a incerteza em vez de assumir Prefix.
Sem teste de rede
Um erro 404 no Ingress pode exigir logs, DNS, EndpointSlices e requisição real. A análise de YAML não comprova que o aplicativo respondeu.
Pod ausente no texto não é falha
O cluster pode ter Pods não colados ou endpoints manuais. Apenas Service ou porta referenciados e ausentes do material fornecido viram quebra comprovada.
Entradas limitadas
Até 300.000 caracteres, 100 recursos e 500 caminhos. Aceita Ingress v1 e Service v1 já renderizados; modelos Helm e Gateway API não são interpretados.

Dúvidas ao testar rotas do Ingress

Por que o Ingress retorna 404 para um caminho configurado?

Host ou caminho diferentes, backend padrão, rewrite e o próprio aplicativo podem gerar 404. Veja a rota estática aqui e confira logs e resposta real para localizar a origem.

O backend do Ingress usa a porta do Service ou o targetPort?

O backend aponta para port ou nome da porta do Service. O Service encaminha essa porta para targetPort; usar diretamente a porta do Pod pode deixar uma referência inexistente.

O Prefix /foo também corresponde a /foobar?

Não. Prefix /foo casa com /foo e /foo/bar, mas não com /foobar. A comparação também diferencia maiúsculas e minúsculas.

Qual regra vence quando Exact e Prefix combinam?

Vence o caminho correspondente mais longo. No empate, Exact tem prioridade sobre Prefix; regras equivalentes em Ingress distintos ficam marcadas como conflito.

O manifesto mostra se o Pod está acessível?

Não. O manifesto não confirma Pod Ready, EndpointSlices, DNS, balanceador ou conectividade do cluster.

Restou alguma dúvida sobre a rota?

Começar a testar rotas do Ingress

Mude Host e caminho do exemplo para conferir a porta selecionada.

A análise fica no navegador.