Ruta guiada: Desplegar infraestructura¶
Guía paso a paso para levantar la infraestructura base de SmallCountry desde cero: servidores, virtualización, almacenamiento, red, identidad y backups.
¿Para quién es esta ruta?¶
Para la persona que va a montar los servidores físicos y la capa de virtualización de 
SmallCountry. Necesitas acceso físico a las máquinas, un switch gestionable, y haber leído la arquitectura resumida. Esta ruta asume que partes de hardware limpio, sin nada instalado.
1. Elegir el hardware¶
Antes de comprar o ensamblar nada, entiende los cuatro nodos que forman la infraestructura y qué rol cumple cada uno.
Sistema de Infraestructura — Topología completa con los nodos Ra, Horus, Geb y Thoth, sus especificaciones y los criterios de selección.
La tabla de servidores te da las especificaciones exactas de cada nodo. No necesitas replicarlas al milímetro, pero sí entender por qué cada componente está ahí.
2. Instalar Proxmox VE¶
Proxmox es el hipervisor que gobierna todos los contenedores LXC. Se instala en los nodos Ra y Horus.
Proxmox VE — Ficha con versión bloqueada, playbook de Ansible, healthchecks y configuración de red.
Después de instalar, verifica el acceso a la interfaz web en https://10.10.1.1:8006 y configura el clúster si tienes más de un nodo con Proxmox.
3. Configurar ZFS¶
ZFS es la base del almacenamiento. Todos los datos persistentes viven en datasets ZFS con snapshots automáticos. Elegido mediante ADR-006.
ZFS — Ficha con la creación de pools, datasets, política de snapshots y comandos de recuperación.
Crea al menos el pool rpool en Ra y hpool en Horus. Configura los snapshots automáticos de 15 minutos antes de pasar al siguiente paso.
4. Configurar la red interna¶
La red de SmallCountry está segmentada en VLANs por propósito. Cada bridge de Proxmox aísla un tipo de tráfico.
Sistema de Comunicaciones — Visión global de la red, bridges de Proxmox, DNS interno con Pi-hole y dominio .sc.
Configura Pi-hole como DNS autoritativo para el dominio .sc. Asigna los rangos IP de cada bridge según la tabla de segmentación.
5. Desplegar Authentik¶
Authentik es el proveedor de identidad que centraliza el inicio de sesión en todos los servicios. Sin Authentik, cada servicio pediría su propia contraseña.
Authentik — Ficha con configuración de flujos, proveedores OAuth2/OIDC, integración con LDAP y respaldo.
Crea al menos los grupos admin, familia y operador. Configura el primer flujo de autenticación con segundo factor (TOTP) para los administradores.
6. Configurar Caddy¶
Caddy es el proxy inverso que da acceso HTTPS a todos los servicios desde fuera y dentro de la red. Maneja los certificados TLS automáticamente.
Caddy — Ficha con Caddyfile, integración con Authentik para SSO y dominios .sc.
Cada nuevo servicio que despliegues necesitará una entrada en el Caddyfile. El patrón es servicio.sc con autenticación delegada a Authentik.
7. Montar el sistema de backups¶
Sin backups, no hay infraestructura. SmallCountry usa dos herramientas complementarias: PBS para snapshots de contenedores y Restic para backups cifrados fuera del sitio.
Proxmox Backup Server — Snapshots automáticos de LXC con verificación de integridad.
Restic — Backups cifrados, incrementales y con destino externo.
Configura PBS para snapshots diarios de los contenedores Tier S y A. Configura Restic con destino en Thoth y verifica que la recuperación funciona antes de seguir.
8. Activar la observabilidad¶
Con la infraestructura funcionando, necesitas saber qué pasa en cada momento. Activa el pipeline completo de métricas, logs y alertas.
Sistema de Observabilidad — Pipeline de métricas, logs, trazas y dashboards unificados.
Empieza por Grafana y Uptime Kuma como mínimo. El resto del stack (VictoriaMetrics, VictoriaLogs, Tempo) puede crecer progresivamente. Si quieres una guía detallada para esta parte, sigue la Ruta de observabilidad.
¿Ya terminaste? Ver también¶
- Desplegar servicios — Con la infraestructura lista, aprende a agregar un servicio nuevo al ecosistema.
- Estado Global — Dashboard de salud de toda la infraestructura desplegada.
- Modo Isla — Cómo se comporta la infraestructura cuando se corta internet.