Tema 2: Deployments y ReplicaSets
Base oficial: (The Kubernetes Authors, 2026a, 2026b). Mi versión de trabajo: Un Deployment es un controlador de rollout. ReplicaSets es la maquinaria que usa para mantener vivos los Pods correctos.
Modelo mental
Un Deployment es un controlador de rollout. ReplicaSets es la maquinaria que usa para mantener vivos los Pods correctos.
Notas
- El rolling update default es bueno hasta que migraciones o compatibilidad hacen inseguro correr dos versiones.
- Lee el historial de rollout antes de adivinar que cambio.
- Un Deployment fallido suele ser problema de imagen, readiness, quota o scheduling.
Ángulo homelab
Esta es la forma default para servicios stateless del homelab: dashboards, APIs, bots y herramientas internas.
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
- Deployments - ruta fuente:
content/en/docs/concepts/workloads/controllers/deployment.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0. - ReplicaSet - ruta fuente:
content/en/docs/concepts/workloads/controllers/replicaset.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). Deployments. https://kubernetes.io/docs/concepts/workloads/controllers/deployment/
The Kubernetes Authors. (2026b). ReplicaSet. https://kubernetes.io/docs/concepts/workloads/controllers/replicaset/