Tema 5: Evolución de API y versionado
Base oficial: (The Kubernetes Authors, 2026b, 2026a). Mi versión de trabajo: Las APIs de Kubernetes evolucionan. Buen trabajo de plataforma sabe de qué versiones depende y cuando vienen migraciones.
Modelo mental
Las APIs de Kubernetes evolucionan. Buen trabajo de plataforma sabe de qué versiones depende y cuando vienen migraciones.
Notas
- API groups y versions son parte del contrato.
- APIs deprecated son trabajo futuro con fecha limite.
- Versionado de CRDs merece el mismo respeto que APIs de aplicación.
Ángulo homelab
Corre checks de deprecation antes de upgrades. Es más barato que descubrir manifests rotos durante mantenimiento.
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
- The Kubernetes API - ruta fuente:
content/en/docs/concepts/overview/kubernetes-api.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0. - Custom Resources - ruta fuente:
content/en/docs/concepts/extend-kubernetes/api-extensión/custom-resources.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). Custom Resources. https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/
The Kubernetes Authors. (2026b). The Kubernetes API. https://kubernetes.io/docs/concepts/overview/kubernetes-api/