yeboyebo-backup-tools

Herramienta de backup PostgreSQL multiplataforma (Linux + Windows) con montaje remoto, replicacion, test de integridad y alertas por email.

Instalacion

pip install yeboyebo-backup-tools

# Opcional: logging remoto a Grafana Loki
pip install yeboyebo-backup-tools[loki]

Uso rapido

# Backup de todas las BBDD listadas en lista.txt
backup-tools db dump lista.txt
backup-tools -v db dump lista.txt        # con log detallado
backup-tools -vv db dump lista.txt       # con log muy detallado

# Restaurar el backup mas reciente de cada BBDD
backup-tools db restore lista.txt

# Dump + restore en servidor replica
backup-tools db replicate lista.txt

# Test de integridad: restaura cada backup en BBDD temporal y verifica
backup-tools db test lista.txt

# Sincronizar backups a NAS / disco remoto (ultimas 12h)
backup-tools file remote /mnt/nas //192.168.1.200/backups
backup-tools file remote /mnt/nas //192.168.1.200/backups 24   # ultimas 24h

# Sincronizar las copias mas recientes (sync_copies) a un NAS Synology por SMB
backup-tools config sync_copies 3
backup-tools file sync /mnt/synology //192.168.1.200/backups lista.txt

# Informe diario por email: ficheros generados en las ultimas 24h
backup-tools resume

# Monitorizar conectividad (envia email si no responde)
backup-tools alive 192.168.1.1

# Gestion de parametros de configuracion
backup-tools config server_name MI_SERVIDOR
backup-tools config user_db postgres true    # true = ofuscar valor

# Version
backup-tools version

Acciones

Configuracion

El fichero config.ini se busca en este orden:

1. Variable de entorno BACKUP_TOOLS_CONFIG
2. ~/.config/backup_tools/config.ini (XDG, recomendado)
3. config.ini junto al modulo (legado)

Parametros principales:

Requisitos

• Python >= 3.8
• pg_dump, psql (PostgreSQL client tools)
• Linux: mount/mount.cifs (solo para file remote)
• Sin dependencias externas de sistema para tar, ping, find, touch (todo stdlib Python)

Compatibilidad Windows

Desde v1.1. Particularidades:

• Montaje: net use en vez de mount/mount.cifs
• nice no disponible (se ignora)
• ping -n en vez de ping -c
• Compresion via tarfile (stdlib), no requiere tar externo
• Programar tareas con Task Scheduler en vez de cron

Ejemplo crontab

# Backup diario 3:17 AM
17 3 * * * cd /opt/backup_tools && backup-tools db dump lista.txt

# Replica a contingencia 5:17 AM
17 5 * * * cd /opt/backup_tools && backup-tools db replicate lista.txt

# Test integridad domingos 7:17 AM
17 7 * * 0 cd /opt/backup_tools && backup-tools db test lista.txt

# Informe diario 8:17 AM
17 8 * * * cd /opt/backup_tools && backup-tools resume

# Ping cada 30 min
*/30 * * * * cd /opt/backup_tools && backup-tools alive 192.168.1.1