Tema 4: Controladores y reconciliación

Base oficial: (The Kubernetes Authors, 2026b, 2026a, 2026c). Mi versión de trabajo: Kubernetes funciona porque los controladores comparan estado deseado con estado observado. Ese loop es el producto.

Modelo mental

Kubernetes funciona porque los controladores comparan estado deseado con estado observado. Ese loop es el producto.

Notas

  • Un controlador normalmente no hace una gran acción unica; hace correcciones pequenas continuamente.
  • La mayoria de recursos de alto nivel son contratos que los controladores interpretan.
  • Debuggear significa leer eventos y preguntar que controlador es dueño de la transicion atorada.

Ángulo homelab

Este modelo hace natural GitOps: Git cambia el estado deseado y los controladores hacen el trabajo mecanico.

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

  • Kubernetes Components - ruta fuente: content/en/docs/concepts/overview/components.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0.
  • Cluster Architecture - ruta fuente: content/en/docs/concepts/architecture/_index.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0.
  • The Kubernetes API - ruta fuente: content/en/docs/concepts/overview/kubernetes-api.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). Cluster Architecture. https://kubernetes.io/docs/concepts/architecture/
The Kubernetes Authors. (2026b). Kubernetes Components. https://kubernetes.io/docs/concepts/overview/components/
The Kubernetes Authors. (2026c). The Kubernetes API. https://kubernetes.io/docs/concepts/overview/kubernetes-api/