Manual de SmallCountry¶
Documentación técnica y operativa del sistema. Aquí están las reglas que lo gobiernan, los mecanismos que lo protegen y los procedimientos que lo mantienen en pie.
-
12 reglas de diseño que no dependen de herramientas concretas. La base sobre la que se construye todo lo demás.
¿Cuáles son los 12 principios?
Desde fuente única de verdad hasta conocimiento compartido. Cada principio es una regla de diseño que todo servicio debe cumplir. No dependen de herramientas ni versiones. -
Cómo el sistema sobrevive cuando las cosas se ponen feas. Degradación, emergencia, contención.
¿Qué pasa si un servicio se cae?
El modo de emergencia prioriza servicios críticos. La degradación independiente asegura que un fallo no se propague. El protocolo de mortalidad planifica la continuidad del sistema. -
Quién decide qué, cómo se toman las decisiones y qué reglas rigen la evolución del sistema.
¿Cómo se gestiona el cambio?
Dos carriles de cambio separan emergencias de evoluciones planificadas. SLOs y puertas de calidad definen cuándo un servicio está listo para producción. -
Procedimientos paso a paso para cuando algo falla. Caída de VPN, servicio caído, backup fallido.
¿Qué hago si algo se rompe?
Sigue el runbook correspondiente: caída de VPN, servicio caído, bomba del sótano o backup fallido. Cada uno tiene síntomas, diagnóstico y resolución. -
Cómo se clasifica el estado de cada servicio. Conjunto cerrado, modo isla, regla de precedencia.
¿Qué significa cada estado?
Conjunto cerrado define qué puede romperse sin que el sistema caiga. Persistencia de salida asegura que los datos no se pierdan. Regla de precedencia determina qué se recupera primero. -
Cómo añadir un nuevo servicio al ecosistema. Paso a paso, de principio a fin.
¿Cómo añado un servicio nuevo?
La guía de despliegue cubre desde la asignación de LXC hasta la integración en Authentik y la monitorización en Grafana. Cada servicio sigue el mismo proceso.