paunin/postgresql-cluster-pgpool

PostDock - Postgres + Docker

PostgreSQL流复制集群，适用于Kubernetes、Docker Compose、Docker Swarm、Apache Mesos等Docker环境。

镜像概述

本镜像属于PostDock项目，提供生产级PostgreSQL集群架构，支持自动故障转移、负载均衡与备份恢复。包含以下组件：

• Postgres节点：支持主从模式，由repmgr管理集群状态
• Pgpool：实现负载均衡与故障转移
• Barman：PostgreSQL备份与恢复工具

核心功能

1. 自动故障转移：通过repmgr实现主节点故障时自动切换
2. 负载均衡：Pgpool分发读写请求到集群节点
3. 备份恢复：Barman提供实时备份与时间点恢复（PITR）
4. 自适应模式：节点启动时自动判断主从角色（支持同级节点）
5. SSH访问：可选启用SSH服务，方便集群管理
6. 复制槽：默认启用Postgres复制槽，确保数据同步

使用场景

• 生产环境高可用PostgreSQL集群部署
• 多环境（Docker Compose/Kubernetes）的数据库集群迁移
• 需要自动备份与故障恢复的数据库场景

配置说明

Postgres配置

通过CONFIGS环境变量设置postgres.conf参数，格式为变量1:值1,变量2:值2。例如：CONFIGS=wal_keep_segments:1000,max_replication_slots:10。

Pgpool配置

• DB_USERS：数据库用户与密码，格式用户1:密码1,用户2:密码2
• BACKENDS：后端节点配置，格式编号:主机:端口:权重:数据目录:标志，例如0:pgmaster:5432:1:/var/lib/postgresql/data:ALLOW_TO_FAILOVER
• REQUIRE_MIN_BACKENDS：启动Pgpool所需的最小后端节点数

Barman配置

• REPLICATION_USER/REPLICATION_PASSWORD：复制用户与密码
• REPLICATION_HOST：主节点地址
• POSTGRES_USER/POSTGRES_PASSWORD：Postgres管理员账号

部署示例

Docker Compose部署

bash
# 克隆项目（可选，获取docker-compose.yml）
git clone https://github.com/paunin/PostDock.git
cd PostDock
# 启动集群
docker-compose up -d

Kubernetes部署

参考项目k8s/example1目录的步骤，执行以下命令（示例）：

bash
kubectl apply -f k8s/example1/
# 查看集群状态
kubectl exec -it <postgres-pod> -- gosu postgres repmgr cluster show

常用命令

• 查看Postgres集群状态：gosu postgres repmgr cluster show
• 查看Pgpool节点状态：PGPASSWORD=$CHECK_PASSWORD psql -U $CHECK_USER -h localhost template1 -c "show pool_nodes"
• 检查Pgpool是否有可写节点：/usr/local/bin/pgpool/has_write_node.sh

## 健康检查
- Postgres节点：`/usr/local/bin/cluster/healthcheck/is_major_master.sh`（检测是否存在假主节点）
- Pgpool节点：`/usr/local/bin/pgpool/has_enough_backends.sh`（检查后端节点数量）

## 文档参考
- Postgres流复制：[***]
- Repmgr：https://github.com/2ndQuadrant/repmgr
- Pgpool2：[***]
- Barman：[***]
- Kubernetes：[***]