Tema 3: StatefulSets
Base oficial: (The Kubernetes Authors, 2026b, 2026a). Mi versión de trabajo: StatefulSet da identidad estable y comportamiento ordenado a Pods. Es para software que nota quién es.
Modelo mental
StatefulSet da identidad estable y comportamiento ordenado a Pods. Es para software que nota quién es.
Notas
- Nombres estables y storage estable son el punto.
- Arranque y apagado ordenado reducen sorpresas para sistemas en cluster.
- StatefulSet no es una estrategia de backup.
Ángulo homelab
Usalo para bases de datos solo después de poder explicar restore, falla de disco y upgrades.
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
- StatefulSets - ruta fuente:
content/en/docs/concepts/workloads/controllers/statefulset.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0. - Persistent Volumes - ruta fuente:
content/en/docs/concepts/storage/persistent-volumes.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). Persistent Volumes. https://kubernetes.io/docs/concepts/storage/persistent-volumes/
The Kubernetes Authors. (2026b). StatefulSets. https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/