Ingress - Airflow

A exposicao do Airflow via Ingress permite o acesso HTTP/HTTPS externo ao cluster atraves de um hostname dedicado.

Ingress vs Gateway API

TDPConfiguration.gateway.ingress e TDPConfiguration.gateway.gatewayApi sao mutuamente exclusivos. Ative apenas um deles.

Pre-requisitos

• Ingress Controller instalado no cluster (ex.: NGINX).
• DNS configurado ou entrada em /etc/hosts a apontar para o IP externo do Ingress.
• Os certificados TLS sao opcionais.

Exemplo de configuracao

TDPConfiguration:
  gateway:
    ingress:
      enabled: true

ingress:
  ingressClassName: <ingress-class>
  hosts:
    - host: airflow.tdp.local
      paths:
        - path: /
          pathType: Prefix
  tls: []

Substitua <ingress-class> pelo nome do Ingress Controller do ambiente (verifique com kubectl get ingressclass).

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>   airflow.tdp.local
3. Aceda a http://airflow.tdp.local (ou https:// se o TLS estiver configurado).

Resolucao de Problemas

Problema	Causa	Solucao
Ingress nao criado	TDPConfiguration.gateway.ingress.enabled: false ou ingressClassName incorreto	Verificar ambas as configuracoes
Host nao resolve	DNS ou /etc/hosts nao configurado	Corrigir a resolucao de nomes no cliente
502 Bad Gateway	Pod do Airflow nao esta pronto	Verificar kubectl get pods -n <namespace>