Roadmap de migración¶
Plan por fases para migrar los servicios de Docker Compose/Portainer al cluster
k3s. Este documento es temporal: vive en legacy/ y se borrará junto con
toda la sección cuando la migración termine.
Fases¶
- Fase 1 — Todo lo nuevo, sin datos a migrar: Terraform (VMs) → k3s → Argo CD → Gateway API + Traefik → MetalLB → Sealed Secrets → cert-manager → Longhorn → CloudNativePG → Kured → Heimdall → Authentik → Vaultwarden + External Secrets → kube-prometheus-stack + Loki + Alloy → ARC → Ansible CI (plan/apply).
- Hecho (out of order): Vaultwarden + External Secrets (VKS), Kured, kube-prometheus-stack + Loki + Alloy + grafana-operator (observabilidad), ARC (runners self-hosted), Ansible CI (plan/apply). Pendiente: — (Fase 1 completada).
- Fase 2 — Servicios simples, sin estado complejo: Grocy, Audiobookshelf,
Kavita, Netboot.xyz + webs de
steph(gorkarevilla.com+www,mirenygorka.gorkarevilla.com;mirenygorka-devretirado). ✅ Webs migradas a Vercel (sep 2026);stephqueda apagada (pendiente de eliminar la VM en Proxmox). - Backup 3-2-1 (prerequisito antes de Fase 3): backup off-host de volúmenes Longhorn a R2/NAS + runbooks de restore. CNPG ya hace backup a R2.
- Pendiente de observabilidad: reglas de alerta de recursos (Grafana
Alerting) + alerta de Kured; métricas de Longhorn (
connection refused), MetalLB, cloudflared, VKS y Loki; re-añadir el dashboard de Longhorn. - Fase 3 — El grueso, con BD/estado: n8n, Grafana, InfluxDB (+ Goldilocks temporal).
- Fase 4 — Complicados (hardware + críticos sin HA): Home Assistant,
Zigbee2MQTT (USB →
kawhi), Frigate (iGPU →kyrie).
Mapa por servicio¶
El detalle servicio a servicio (fase y destino en k3s) está en el
mapa de migración de legacy/index.md. El
procedimiento paso a paso para migrar un servicio está en
migrar-servicio.md.