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/