diff --git a/homelab/platform-40/BACKUP-RESTORE.md b/homelab/platform-40/BACKUP-RESTORE.md new file mode 100644 index 0000000..e58d018 --- /dev/null +++ b/homelab/platform-40/BACKUP-RESTORE.md @@ -0,0 +1,76 @@ +# BACKUP-RESTORE + +## Alcance + +Este documento cubre la capa documental y técnica versionada de `platform-40` dentro de Gitea. + +No cubre por sí solo: + +- backup real de volúmenes Docker +- dumps de PostgreSQL +- backup de MinIO +- backup de Grafana +- backup de Portainer +- backup de Mosquitto +- restore completo extremo a extremo ya probado + +## Qué debe quedar versionado aquí + +- documentación de servicios +- rutas clave +- puertos y criterios de acceso +- advertencias críticas +- comandos de operación +- referencias a `docker-compose.yml` saneados + +## Qué no debe guardarse aquí + +- credenciales +- secretos +- `.env` reales +- dumps de base de datos +- backups binarios +- exports sin sanear + +## Advertencia crítica principal + +Nunca usar en `/srv/platform`: + +```bash +docker-compose down -v +```` + +porque elimina volúmenes persistentes de: + +* Grafana +* MinIO +* Portainer +* Mosquitto + +## Procedimiento mínimo de backup lógico + +1. verificar que la documentación de plataforma está actualizada +2. verificar que los `docker-compose.yml` saneados están versionados cuando proceda +3. verificar que las rutas clave siguen siendo correctas +4. no asumir que un servicio está sano solo porque el puerto escucha + +## Procedimiento mínimo de restore lógico + +1. revisar `docs/arquitectura.md` +2. revisar `docs/servicios.md` +3. revisar `docs/rutas-clave.md` +4. validar los stacks: + + * `/srv/platform` + * `/srv/chirpstack` + * `/srv/verticals` +5. restaurar con extremo cuidado los servicios persistentes +6. nunca destruir volúmenes sin backup previo + +## Validación mínima + +* `README.md` presente +* `docs/arquitectura.md` presente +* `docs/servicios.md` presente +* `docs/rutas-clave.md` presente +* `ops/operacion-diaria.md` presente \ No newline at end of file