gfdsa/patroni-consul-wal-g

gfdsa/patroni-consul-wal-g镜像说明

镜像概述

本镜像基于afefelov/patroni-class-pg-walg fork而来，集成了Patroni（PostgreSQL高可用管理工具）、Consul（服务发现与协调工具）和WAL-G（PostgreSQL备份恢复工具），用于快速搭建3节点PostgreSQL高可用集群。

核心功能

• PostgreSQL高可用管理：通过Patroni实现集群节点的自动故障转移、主从切换和配置同步
• 服务发现与协调：利用Consul完成集群节点的注册、健康检查和状态同步
• 备份恢复支持：集成WAL-G工具，实现PostgreSQL的增量备份、全量备份及恢复操作
• 3节点集群部署：默认支持基础3节点Consul+PostgreSQL集群架构

使用场景

• 中小型企业PostgreSQL数据库的高可用生产环境部署
• 开发测试环境中PostgreSQL集群的快速搭建
• 需要定期备份与恢复功能的PostgreSQL应用场景

配置说明

关键环境变量

• POSTGRES_PASSWORD：PostgreSQL超级用户密码（必填）
• CONSUL_URL：Consul服务地址（如consul:8500，必填）
• PATRONI_NAME：Patroni节点名称（如node1，每个节点需唯一）
• WALG_S3_PREFIX：WAL-G备份存储路径（如S3或兼容对象存储地址，可选）

部署示例

Docker Run命令（单节点测试）

bash
docker run -d \
  --name patroni-node1 \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e CONSUL_URL=consul:8500 \
  -e PATRONI_NAME=node1 \
  -p 5432:5432 \
  gfdsa/patroni-consul-wal-g

Docker Compose示例（3节点集群）

yaml
version: '3.8'
services:
  consul:
    image: consul:1.15
    command: agent -server -bootstrap-expect=1 -client=0.0.0.0
    ports:
      - "8500:8500"
  
  patroni-node1:
    image: gfdsa/patroni-consul-wal-g
    environment:
      POSTGRES_PASSWORD: your_secure_password
      CONSUL_URL: consul:8500
      PATRONI_NAME: node1
    ports:
      - "5432:5432"
  
  patroni-node2:
    image: gfdsa/patroni-consul-wal-g
    environment:
      POSTGRES_PASSWORD: your_secure_password
      CONSUL_URL: consul:8500
      PATRONI_NAME: node2
  
  patroni-node3:
    image: gfdsa/patroni-consul-wal-g
    environment:
      POSTGRES_PASSWORD: your_secure_password
      CONSUL_URL: consul:8500
      PATRONI_NAME: node3

注意事项

• 生产环境中需确保Consul集群的高可用配置（至少3节点）
• 建议配置WAL-G备份存储以保障数据安全
• 各节点需保持网络互通，确保Consul与Patroni的通信正常
• 需根据实际需求调整PostgreSQL的资源限制（如内存、CPU）