Ingress — Superset

A exposição do Superset via Ingress permite acesso externo ao cluster usando um hostname dedicado. O chart tdp-superset usa a configuração de Ingress do subchart upstream, sob a chave superset.ingress.

Pré-requisitos

• Ingress Controller instalado no cluster (ex.: NGINX).
• Entrada DNS a apontar para o IP do Ingress Controller (ou configuração local em /etc/hosts para testes).
• Emissão de certificados: opcional, via cert-manager para TLS automático.

Exemplo de configuração

Ingress vs Gateway API

TDPConfiguration.gateway.ingress e TDPConfiguration.gateway.gatewayApi são mutuamente exclusivos. Habilite apenas um deles.

TDPConfiguration:
  gateway:
    ingress:
      enabled: true

superset:
  ingress:
    ingressClassName: "<ingress-class>"
    hosts:
      - superset.tdp.local
    path: /
    pathType: ImplementationSpecific
    tls: []

Substitua <ingress-class> pelo nome do Ingress Controller do ambiente (verifique com kubectl get ingressclass). Para TLS, configure o bloco tls conforme o template do chart.

Acesso

1. Obtenha o IP externo do Ingress Controller:
   Terminal input

   kubectl get svc -A -l app.kubernetes.io/name=ingress-nginx \
     -o jsonpath='{.items[0].status.loadBalancer.ingress[0].ip}'
2. Adicione o hostname no DNS ou no ficheiro /etc/hosts:

   <INGRESS_IP>   superset.tdp.local
3. Aceda a http://superset.tdp.local/ (ou https:// se o TLS estiver configurado).

Troubleshooting

Problema	Causa	Solução
Ingress não criado	superset.ingress.enabled: false ou ingressClassName incorreto	Habilitar o campo no values e ajustar ingressClassName para o Ingress Controller do ambiente
Host não resolve	DNS ou /etc/hosts não configurado	Ajustar resolução no cliente
TLS falha	Issuer ou Secret incorrectos	Verificar cert-manager e o Secret TLS
Erro 502/503	Pod do Superset não está pronto	Verificar estado com kubectl get pods