Implementación práctica de backups PITR para PostgreSQL con WAL‑G y S3
Introducción
En entornos de producción, la pérdida de datos puede traducirse en interrupciones costosas y daño reputacional. PostgreSQL ofrece point‑in‑time recovery (PITR), una técnica que permite volver a cualquier momento exacto dentro del periodo de retención de los Write‑Ahead Logs (WAL). Este artículo muestra cómo implementar una solución robusta de PITR usando WAL‑G como herramienta de backup, almacenando los archivos en Amazon S3 y automatizando tanto la captura como la verificación de la restauración.
Se cubrirán:
- Instalación y configuración de WAL‑G.
- Preparación del clúster PostgreSQL para generar WALs compatibles.
- Creación de políticas de backup en S3.
- Automatización con systemd timers.
- Procedimientos de prueba de restauración y troubleshooting.
1. Preparación del entorno PostgreSQL
1.1. Versiones recomendadas
WAL‑G requiere PostgreSQL ≥ 9.6 y una versión de pg_protobuf compatible. En producción se recomienda PostgreSQL 13 o superior por mejoras en el manejo de WAL y en la compresión.
1.2. Configuración de WAL
Edite postgresql.conf y ajuste los siguientes parámetros para asegurar que los WAL sean archivados y retenidos:
# postgresql.conf
wal_level = replica # Necesario para generar WAL suficiente
archive_mode = on
archive_command = 'wal-g wal-push %p' # WAL‑G se encargará del push a S3
max_wal_senders = 5
wal_keep_size = 1024 # 1 GB de WAL retenido localmente
archive_timeout = 600 # Forzar archivado cada 10 min
Después de modificar, recargue la configuración:
# systemctl reload postgresql
1.3. Crear rol de backup
Para que WAL‑G pueda leer los archivos de base de datos sin usar el usuario postgres, cree un rol dedicado:
# psql -U postgres
CREATE ROLE walg_user LOGIN PASSWORD 'SecretoFuerte';
GRANT CONNECT ON DATABASE tu_base TO walg_user;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO walg_user;
ALTER ROLE walg_user SET search_path = public;
2. Instalación y configuración de WAL‑G
2.1. Instalación binaria
En sistemas basados en Debian/Ubuntu:
# apt-get update
# apt-get install -y wget gnupg2
# wget https://github.com/wal-g/wal-g/releases/download/v2.0.1/wal-g-pg-ubuntu-20.04-amd64.tar.gz
# tar -xzf wal-g-pg-ubuntu-20.04-amd64.tar.gz -C /usr/local/bin
# chmod +x /usr/local/bin/wal-g
Verifique la instalación:
# wal-g --version
wal-g version v2.0.1
2.2. Configuración de variables de entorno
WAL‑G usa variables de entorno para definir el backend de almacenamiento. Cree un archivo /etc/wal-g.env con permisos restringidos:
# cat /etc/wal-g.env
export WALG_S3_PREFIX=s3://mi-bucket-postgres/backups
export AWS_ACCESS_KEY_ID=AKIAxxxxxxxxxxxx
export AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export AWS_DEFAULT_REGION=us-east-1
export WALE_S3_PREFIX=$WALG_S3_PREFIX
export WALE_S3_ENDPOINT= # opcional, para S3 compatible (MinIO, Ceph)
Luego, cargue estas variables en el servicio de PostgreSQL (systemd):
# cat /etc/systemd/system/postgresql.service.d/walg.conf
[Service]
EnvironmentFile=/etc/wal-g.env
# systemctl daemon-reload
# systemctl restart postgresql
2.3. Prueba de push manual
Para confirmar que WAL‑G puede subir un archivo WAL:
# wal-g wal-push /var/lib/postgresql/13/main/pg_wal/0000000100000000000000A1
Revise en S3 que el objeto exista:
# aws s3 ls s3://mi-bucket-postgres/backups/wal/
3. Automatización de backups completos y de WAL
3.1. Backup base (base backup)
Ejecute un backup inicial completo (base backup) con WAL‑G. Este proceso crea una snapshot consistente y la sube a S3:
# wal-g backup-push /var/lib/postgresql/13/main
WAL‑G generará un manifest y lo almacenará en base_XXXX.tar.gz. Anote la salida, ya que el backup name será necesario para restauraciones.
3.2. Programación con systemd timers
Crear dos timers:
- wal‑g‑push.timer para subir WAL cada 15 min (aunque
archive_commandya lo hace, el timer sirve como fallback). - wal‑g‑backup.timer para generar un backup completo semanal.
Archivo /etc/systemd/system/wal-g-push.service:
[Unit] Description=Push pending WAL files to S3 via WAL‑G
[Service] Type=oneshot EnvironmentFile=/etc/wal-g.env ExecStart=/usr/local/bin/wal-g wal-push %p
Timer asociado:
[Unit] Description=Timer to push WAL every 15 minutes[Timer] OnBootSec=5min OnUnitActiveSec=15min Persistent=true
[Install] WantedBy=timers.target
Backup semanal:
# /etc/systemd/system/wal-g-backup.service [Unit] Description=Weekly base backup with WAL‑G[Service] Type=oneshot EnvironmentFile=/etc/wal-g.env ExecStart=/usr/local/bin/wal-g backup-push /var/lib/postgresql/13/main
/etc/systemd/system/wal-g-backup.timer
[Unit] Description=Run weekly base backup
[Timer] OnCalendar=weekly Persistent=true
[Install] WantedBy=timers.target
Habilite y arranque los timers:
# systemctl enable --now wal-g-push.timer wal-g-backup.timer
3.3. Retención y limpieza
WAL‑G incluye comandos de delete para eliminar backups y WAL obsoletos. Programemos una tarea mensual:
# cat /etc/systemd/system/wal-g-prune.service [Unit] Description=Prune old WAL‑G backups[Service] Type=oneshot EnvironmentFile=/etc/wal-g.env ExecStart=/usr/local/bin/wal-g delete retain FULL 3 —confirm
timer
[Timer] OnCalendar=monthly Persistent=true
enable
systemctl enable —now wal-g-prune.timer
Este comando mantiene los últimos 3 backups completos y elimina WALs que ya no son necesarios para los puntos de recuperación cubiertos por esos backups.
4. Pruebas de restauración (PITR)
4.1. Escenario de prueba
Una buena práctica es validar la cadena de recuperación al menos una vez al mes. Simularemos una falla recortando la base de datos y restaurando a un punto arbitrario.
4.2. Pasos de restauración
- Crear un clúster vacío en otra máquina o contenedor:
# initdb -D /var/lib/postgresql/13/restore
# pg_ctl -D /var/lib/postgresql/13/restore start
- Descargar el backup base deseado:
# export $(cat /etc/wal-g.env | xargs)
# wal-g backup-fetch /var/lib/postgresql/13/restore LATEST
- Configurar recovery.conf (PostgreSQL 12‑) o
postgresql.auto.conf(PostgreSQL 13+):
# cat > /var/lib/postgresql/13/restore/recovery.conf <
En versiones 13+, el archivo se llama postgresql.auto.conf y se habilita restore_command vía ALTER SYSTEM o directamente en postgresql.conf:
# echo "restore_command = 'wal-g wal-fetch %f %p'" >> /var/lib/postgresql/13/restore/postgresql.conf
# echo "recovery_target_time = '2026-05-20 14:30:00'" >> /var/lib/postgresql/13/restore/postgresql.conf
- Iniciar la recuperación:
# pg_ctl -D /var/lib/postgresql/13/restore start
PostgreSQL aplicará los WALs desde S3 hasta alcanzar el timestamp indicado y luego terminará en modo “ready”.
4.3. Verificación de integridad
Una vez restaurado, ejecute consultas de validación:
# psql -d tu_base -c "\dt"
# psql -d tu_base -c "SELECT count(*) FROM tabla_critica;"
Compare los resultados con los esperados (puede usar un checksum almacenado previamente).
5. Troubleshooting y errores comunes
5.1. WAL no se sube a S3
- Símbolo de error: “archive command failed with exit code 1”.
- Causa típica: variables de entorno no cargadas en el proceso de PostgreSQL.
- Solución: Verifique
systemctl show postgresql -p Environment y asegúrese de que WALG_S3_PREFIX esté presente.
5.2. “file not found” al ejecutar wal-g wal-fetch
- Compruebe que el prefix S3 coincida con el usado en backup (
WALG_S3_PREFIX).
- Revise permisos del bucket (política IAM) y que la clave tenga
s3:GetObject.
5.3. Restauración se queda en “recovery” indefinidamente
- Posible falta de WALs necesarios para alcanzar el
recovery_target_time.
- Ejecute
wal-g wal-verify --target-time "2026-05-20 14:30:00" para identificar los WAL faltantes.
- Si faltan, aumente el período de retención o corrige la política de
delete retain.
5.4. Problemas de rendimiento al hacer backup-push
- El proceso puede saturar el disco I/O. Use la opción
--threads para paralelizar la compresión:
# wal-g --threads=4 backup-push /var/lib/postgresql/13/main
- Considere montar un disco SSD temporal para la fase de compresión.
5.5. Errores de “InvalidSignature” de AWS
- Normalmente indica reloj del servidor desincronizado.
- Corrija con
timedatectl set-ntp true y sincronice con NTP.
Conclusión
Implementar backups PITR con WAL‑G y S3 brinda a los administradores de PostgreSQL una solución escalable, segura y de bajo coste. La clave del éxito radica en:
- Configurar correctamente los parámetros de WAL y
archive_command.
- Mantener las variables de entorno sincronizadas entre PostgreSQL y los servicios de systemd.
- Automatizar tanto la captura de WAL como los backups completos mediante timers.
- Realizar pruebas de restauración periódicas para garantizar que la cadena de backup sea íntegra.
Siguiendo este procedimiento, su infraestructura podrá recuperarse a cualquier punto dentro del horizonte de retención, minimizando el tiempo de inactividad y asegurando la continuidad del negocio.