Files
SKEEN-Proyecto/infra/ops/README.md

65 lines
2.6 KiB
Markdown

# infra/ops — backups automáticos y panel multi-instancia
Operación comercial de la VPS: backups verificados por instancia y un panel/CLI
para administrar todas las instancias SKEEN. Guía completa:
[`../../docs/producto/operacion-instancia.md`](../../docs/producto/operacion-instancia.md).
Las instancias **no se hardcodean**: se descubren desde las unidades
`odoo-*.service` (leyendo de cada una su `-c <conf>`). Una instancia nueva creada
con `infra/provision/` entra sola.
## Comandos rápidos
```bash
cd /root/skeen-proyecto/infra/ops
# ---- Backups ----
./backup_instancias.sh # todas las instancias (dump + config + rotación)
./backup_instancias.sh --instancia skeen # solo una
./backup_instancias.sh --verificar # + prueba de restauración real
./backup_instancias.sh --solo-db # sin respaldar configuración
./backup_instancias.sh --dry-run # simular (incluye plan de rotación)
# ---- Panel ----
./admin_instancias.py listar # tabla de instancias (por defecto)
./admin_instancias.py estado skeen
./admin_instancias.py version
./admin_instancias.py uso
./admin_instancias.py instalacion clinica2
./admin_instancias.py logs clinica2 -n 30
./admin_instancias.py credenciales skeen # solo la ruta
./admin_instancias.py credenciales skeen --mostrar # incluye passwords
./admin_instancias.py backup skeen --yes # acción que cambia estado
./admin_instancias.py --json listar # salida JSON
# ---- Estado de los timers ----
systemctl list-timers | grep skeen
journalctl -u skeen-backup.service -n 50
tail -f /var/log/skeen-backup.log
```
## Retención (en `backup.env`)
Por defecto **14 diarios / 8 semanales / 6 mensuales** (esquema abuelo-padre-hijo
con buckets exclusivos). El backup más reciente y el representante mensual nunca
se borran. Cambiar `RETAIN_*` en `backup.env` para ajustar.
## Instalación de las unidades
```bash
cp systemd/*.service systemd/*.timer /etc/systemd/system/
cp logrotate/skeen-backup /etc/logrotate.d/skeen-backup
systemctl daemon-reload
systemctl enable --now skeen-backup.timer skeen-backup-verify.timer
```
## Estructura
| Archivo | Para qué |
|---|---|
| `backup_instancias.sh` | Backup por instancia (dump + config, integridad, rotación, `--verificar`). |
| `backup.env` | Destinos, credenciales de DB, retención, log. |
| `admin_instancias.py` | Panel/CLI multi-instancia (stdlib, read-only por defecto). |
| `systemd/` | `skeen-backup*` (diario + verificación semanal) y `backup-instancia@` (por instancia). |
| `logrotate/skeen-backup` | Rotación de `/var/log/skeen-backup.log`. |