Tema 5: Ingress y Gateway API

Base oficial: (The Kubernetes Authors, 2026b, 2026a). Mi versión de trabajo: Ingress y Gateway API son capas de manejo de tráfico encima de Services. Deciden como tráfico HTTP externo llega a backends internos.

Modelo mental

Ingress y Gateway API son capas de manejo de tráfico encima de Services. Deciden como tráfico HTTP externo llega a backends internos.

Notas

  • Ingress necesita un ingress controller; el objeto API solo no es el dataplane.
  • Gateway API es más explicito sobre roles y routing avanzado.
  • TLS, hostnames y reglas de path son contratos operativos, no solo annotations.

Ángulo homelab

Usa una sola ruta de ingress o gateway y documenta DNS, certificados y exposición LAN juntos.

Cómo verificarlo

  • Lee el status del objeto antes de cambiar el manifest.
  • Revisa events para encontrar el controlador o nodo que realmente se queja.
  • Confirma que la fuente oficial abajo todavía coincide con la versión del cluster que corres.

Modos de falla comunes

  • Tratar el objeto YAML como el sistema, en vez de verlo como una entrada a un loop de reconciliación.
  • Debuggear desde fuera del cluster cuando la falla solo existe dentro de networking o estado de nodo.
  • Olvidar que versión de Kubernetes, versión de addon y comportamiento de runtime están conectados.

Fuentes

  • Ingress - ruta fuente: content/en/docs/concepts/services-networking/ingress.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0.
  • Gateway API - ruta fuente: content/en/docs/concepts/services-networking/gateway.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0.
  • La documentación de Kubernetes usa licencia CC BY 4.0; estas notas son comentario original y enlazan a la fuente oficial.
The Kubernetes Authors. (2026a). Gateway API. https://kubernetes.io/docs/concepts/services-networking/gateway/
The Kubernetes Authors. (2026b). Ingress. https://kubernetes.io/docs/concepts/services-networking/ingress/