Tema 1: ConfigMaps

Base oficial: (The Kubernetes Authors, 2026). Mi versión de trabajo: ConfigMaps separan configuración no secreta de imágenes para que el mismo artefacto corra en distintos entornos.

Modelo mental

ConfigMaps separan configuración no secreta de imágenes para que el mismo artefacto corra en distintos entornos.

Notas

• ConfigMaps pueden volverse variables de entorno, archivos o valores leidos por API.
• Cambiar config no siempre equivale a reiniciar la app.
• Config grande o muy estructurada puede necesitar ownership más fuerte que un map suelto.

Ángulo homelab

Mantén config de apps legible y versionada. ConfigMaps misteriosos son outages futuros.

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

• ConfigMaps - ruta fuente: content/en/docs/concepts/configuration/configmap.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. (2026). ConfigMaps. https://kubernetes.io/docs/concepts/configuration/configmap/