76 lines
1.7 KiB
Markdown
76 lines
1.7 KiB
Markdown
# 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 |