PostgreSQL集群中WAL-G备份恢复配置指南

背景介绍

PostgreSQL集群管理工具Patroni结合WAL-G可以实现高效的数据库备份和恢复方案。WAL-G作为PostgreSQL的归档工具，能够将WAL日志和基础备份存储到S3兼容的对象存储中，如MinIO服务器。

安装配置WAL-G

在PostgreSQL集群中配置WAL-G需要特别注意版本选择。推荐使用3.0.2及以上版本，因为早期版本存在编译依赖问题。安装时需确保系统已安装必要的依赖项：

gmake
gcc
git
go

关键配置参数

在vars/main.yml文件中，WAL-G的核心配置应包括：

wal_g_install: true
wal_g_version: "3.0.2"
wal_g_path: "/usr/local/bin/wal-g --config /var/lib/postgresql/.walg.json"

MinIO存储配置

当使用MinIO作为备份存储时，需要配置以下参数：

wal_g_json:
  - { option: "AWS_ACCESS_KEY_ID", value: "minio访问密钥" }
  - { option: "AWS_SECRET_ACCESS_KEY", value: "minio密钥" }
  - { option: "WALG_S3_PREFIX", value: "s3://备份路径" }
  - { option: "AWS_S3_FORCE_PATH_STYLE", value: "true" }
  - { option: "AWS_ENDPOINT", value: "http://minio服务器地址:9000" }

集群引导方式选择

PostgreSQL集群支持两种引导方式：

1. initdb方式：创建全新的空集群，适用于首次部署
2. wal-g方式：从已有备份恢复集群，适用于灾难恢复或创建副本

在vars/main.yml中配置：

patroni_cluster_bootstrap_method: "initdb"  # 或 "wal-g"

备份策略配置

实现自动化备份需要配置cron任务：

wal_g_backup_command:
  - "curl -I -s http://{{ inventory_hostname }}:{{ patroni_restapi_port }} | grep 200"
  - " && {{ wal_g_path }} backup-push {{ postgresql_data_dir }} > {{ postgresql_log_dir }}/walg_backup.log 2>&1"

wal_g_cron_jobs:
  - name: "WAL-G: 每日备份"
    user: "postgres"
    file: /etc/cron.d/walg
    minute: "30"
    hour: "*"
    job: "{{ wal_g_backup_command | join('') }}"

备份保留策略

配置自动清理旧备份：

wal_g_delete_command:
  - "curl -I -s http://{{ inventory_hostname }}:{{ patroni_restapi_port }} | grep 200"
  - " && {{ wal_g_path }} delete retain FULL 7 --confirm > {{ postgresql_log_dir }}/walg_delete.log 2>&1"

wal_g_cron_jobs:
  - name: "WAL-G: 清理旧备份"
    user: "postgres"
    file: /etc/cron.d/walg
    minute: "28"
    hour: "4"
    job: "{{ wal_g_delete_command | join('') }}"

常见问题解决

1. 编译错误：确保使用WAL-G 3.0.2及以上版本
2. 备份失败：检查MinIO连接配置和权限
3. 恢复超时：确认备份文件存在且可访问
4. cron不执行：检查wal-g路径配置是否正确

最佳实践

1. 首次部署使用initdb方式创建新集群
2. 定期测试备份恢复流程
3. 监控备份作业执行情况
4. 根据业务需求调整备份保留策略
5. 确保备份存储有足够的空间

通过合理配置WAL-G，可以构建可靠的PostgreSQL数据库备份恢复体系，保障数据安全性和业务连续性。