Tema 1: Custom Resources
Base oficial: (The Kubernetes Authors, 2026a, 2026b). Mi versión de trabajo: Un Custom Resource agrega una nueva forma de API. Se vuelve útil cuando un controlador lo reconcilia.
Modelo mental
Un Custom Resource agrega una nueva forma de API. Se vuelve útil cuando un controlador lo reconcilia.
Notas
- CRDs extienden la API, pero no agregan comportamiento automáticamente.
- La calidad del schema importa porque usuarios construiran automatizacion alrededor.
- Versionado es un compromiso de producto.
Ángulo homelab
Construye un CRD pequeno solo después de entender el ciclo de vida de objetos built-in.
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
- Custom Resources - ruta fuente:
content/en/docs/concepts/extend-kubernetes/api-extensión/custom-resources.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). 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/