postgresql-repmgr-pgpool

荧523

721人浏览 · 2026-02-05 23:19:27

荧523 · 2026-02-05 23:19:27 发布

一、概述

1.架构图

                            +------------------+
                            |   Application    |
                            +------------------+
                                      ↓
                              +---------------+
                              |   pgpool-II    | ← 提供统一入口
                              +---------------+
                               ↙              ↘
                +------------------+    +------------------+
                | PostgreSQL 主库   |    | PostgreSQL 备库   |
                | (Primary)        |    | (Standby)         |
                | running repmgrd  |    | running repmgrd   |
                +------------------+    +------------------+
                         ↑                        ↑
                   流复制 + repmgr 管理集群状态与故障切换

repmgr 管理 PostgreSQL 实例之间的复制关系和 failover；
pgpool-II 连接到所有 PostgreSQL 实例，根据 SQL 类型路由请求；
当主库宕机时，repmgr 自动提拔备库为新主库，并通知 pgpool 更新后端状态。

2.工作原理详解

1. 正常运行时

repmgr 维护主从复制链路，监控节点状态。
pgpool-II：
- 将 INSERT/UPDATE/DELETE 发往当前主库；
- 将 SELECT 分发到多个备库（实现读写分离）；
- 使用连接池减少数据库连接开销。

2. 主库宕机 → 故障转移发生

repmgrd 检测到主库不可达；
触发自动故障转移，选择一个延迟最小的备库提升为新主库；
更新集群元数据，其他备库指向新主库重做复制；

二、实施

1.创建目录

#挂载目录
mkdir -p /data/pgsql/pg{0..2}
mkdir -p /data/pgsql/pgpool/{data,logs,conf}
#授权，默认权限也是775
chmod 775 /data/pgsql/pg{0..2}
chmod 775 sudo mkdir -p /data/pgsql/pgpool/{data,logs,conf}
#项目目录
mkdir -p /root/pg_ha_cluster/pg_cluster
mkdir -p /root/pg_ha_cluster/pgpool

[root@vm-centos7-181 ~]# tree -L 3 pg_ha_cluster/
pg_ha_cluster/
├── pg_cluster
│   └── docker-compose.yaml
└── pgpool
    └── docker-compose.yaml

2 directories, 2 files

[root@vm-centos7-181 pgsql]# cd /data/pgsql/ && tree -L 2
.
├── pg0
│   ├── conf
│   ├── data
│   └── lock
├── pg1
│   ├── conf
│   ├── data
│   └── lock
├── pg2
│   ├── conf
│   ├── data
│   └── lock
└── pgpool
    ├── conf
    ├── data
    └── logs

16 directories, 0 files

2.部署pgcluster

vim /root/pg_ha_cluster/pg_cluster/docker-compose.yaml

# PostgreSQL 高可用性集群配置（使用 repmgr）
services:
  # 主节点配置
  pg-0:
    image: docker.m.daocloud.io/bitnami/postgresql-repmgr:17
    container_name: pg-0
    ports:
      - 5432:5432 
    volumes:
      - pg_0_data:/bitnami/postgresql
    environment:
      # PostgreSQL 配置
      - POSTGRESQL_POSTGRES_PASSWORD=admin
      - POSTGRESQL_USERNAME=postgres
      - POSTGRESQL_PASSWORD=postgres
      - POSTGRESQL_DATABASE=postgres
      
      # repmgr 必要认证配置（新增）
      - REPMGR_USERNAME=repmgr
      - REPMGR_PASSWORD=repmgr
      - REPMGR_DATABASE=repmgr
      
      # repmgr 集群配置
      #- REPMGR_NODE_ID=1
      - REPMGR_NODE_NAME=pg-0
      - REPMGR_NODE_NETWORK_NAME=pg-0
      - REPMGR_PRIMARY_HOST=pg-0
      - REPMGR_PRIMARY_PORT=5432
      - REPMGR_PARTNER_NODES=pg-0,pg-1,pg-2:5432
      - REPMGR_PORT_NUMBER=5432

  # 备用节点 1 配置 
  pg-1:
    image: docker.m.daocloud.io/bitnami/postgresql-repmgr:17
    container_name: pg-1
    ports:
      - 5433:5432 
    volumes:
      - pg_1_data:/bitnami/postgresql
    environment:
      # PostgreSQL 配置
      - POSTGRESQL_POSTGRES_PASSWORD=admin
      - POSTGRESQL_USERNAME=postgres
      - POSTGRESQL_PASSWORD=postgres
      - POSTGRESQL_DATABASE=postgres
      
      # repmgr 必要认证配置（新增）
      - REPMGR_USERNAME=repmgr
      - REPMGR_PASSWORD=repmgr
      - REPMGR_DATABASE=repmgr
      
      # repmgr 集群配置
      #- REPMGR_NODE_ID=2
      - REPMGR_NODE_NAME=pg-1
      - REPMGR_NODE_NETWORK_NAME=pg-1
      - REPMGR_PRIMARY_HOST=pg-0  # 指向主节点
      - REPMGR_PRIMARY_PORT=5432
      - REPMGR_PARTNER_NODES=pg-0,pg-1,pg-2:5432
      - REPMGR_PORT_NUMBER=5432

  # 备用节点 2 配置
  pg-2:
    image: docker.m.daocloud.io/bitnami/postgresql-repmgr:17
    container_name: pg-2
    ports:
      - 5434:5432 
    volumes:
      - pg_2_data:/bitnami/postgresql
    environment:
      # PostgreSQL 配置
      - POSTGRESQL_POSTGRES_PASSWORD=admin
      - POSTGRESQL_USERNAME=postgres
      - POSTGRESQL_PASSWORD=postgres
      - POSTGRESQL_DATABASE=postgres
      
      # repmgr 必要认证配置（新增）
      - REPMGR_USERNAME=repmgr
      - REPMGR_PASSWORD=repmgr
      - REPMGR_DATABASE=repmgr
      
      # repmgr 集群配置
      #- REPMGR_NODE_ID=3
      - REPMGR_NODE_NAME=pg-2
      - REPMGR_NODE_NETWORK_NAME=pg-2
      - REPMGR_PRIMARY_HOST=pg-0  # 指向主节点
      - REPMGR_PRIMARY_PORT=5432
      - REPMGR_PARTNER_NODES=pg-0,pg-1,pg-2:5432
      - REPMGR_PORT_NUMBER=5432

# 定义持久化卷
volumes:
  pg_0_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pg0
  pg_1_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pg1
  pg_2_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pg2

2.1.注释

以pg-0为例：

environment:
  # PostgreSQL 配置
  - POSTGRESQL_POSTGRES_PASSWORD=admin        # PostgreSQL 超级用户(postgres)的密码
  - POSTGRESQL_USERNAME=postgres              # 创建的应用数据库用户名
  - POSTGRESQL_PASSWORD=postgres              # 应用数据库用户的密码  
  - POSTGRESQL_DATABASE=postgres              # 创建的默认数据库名称
  
  # repmgr 必要认证配置
  - REPMGR_USERNAME=repmgr                    # repmgr 元数据管理用户名
  - REPMGR_PASSWORD=repmgr                    # repmgr 用户的密码
  - REPMGR_DATABASE=repmgr                    # 存储复制元数据的数据库名
  
  # repmgr 集群配置
  #- REPMGR_NODE_ID=1                         # 节点唯一ID（主节点=1，备用节点=2,3）
  - REPMGR_NODE_NAME=pg-0                     # 当前节点在集群中的逻辑名称
  - REPMGR_NODE_NETWORK_NAME=pg-0             # 节点在网络中的可解析名称
  - REPMGR_PRIMARY_HOST=pg-0                  # 主节点地址（备用节点应指向pg-0）
  - REPMGR_PRIMARY_PORT=5432                  # 主节点的PostgreSQL端口
  - REPMGR_PARTNER_NODES=pg-0,pg-1,pg-2:5432  # 集群节点列表
  - REPMGR_PORT_NUMBER=5432                   # repmgr守护进程监听端口

启动

cd /root/pg_ha_cluster/pg_cluster &&  docker-compose up -d

3.部署pgpool

vim /root/pg_ha_cluster/pgpool/docker-compose.yaml

services:
  pgpool:
    image: swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/bitnami/pgpool:4.6.2-debian-12-r1
    container_name: pgpool
    restart: always
    ports:
      - "9996:5432"
    volumes:
      # 使用命名卷挂载数据目录
      - pgpool_data:/opt/bitnami/pgpool
      # 挂载自定义配置文件
      - pgpool_conf:/opt/bitnami/pgpool/conf/
      # 挂载日志目录
      - pgpool_logs:/opt/bitnami/pgpool/logs
    environment:
      - PGPOOL_BACKEND_NODES=0:pg-0:5432,1:pg-1:5433,2:pg-2:5434
      - PGPOOL_SR_CHECK_USER=postgres
      - PGPOOL_SR_CHECK_PASSWORD=postgres
      - PGPOOL_ENABLE_LDAP=no
      - PGPOOL_POSTGRES_USERNAME=postgres
      - PGPOOL_POSTGRES_PASSWORD=postgres
      - PGPOOL_ADMIN_USERNAME=postgres
      - PGPOOL_ADMIN_PASSWORD=postgres
    extra_hosts:
      - "pg-0:192.168.0.181"
      - "pg-1:192.168.0.181"
      - "pg-2:192.168.0.181"

# 定义数据卷
volumes:
  pgpool_data:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pgpool/data
  pgpool_conf:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pgpool/conf
  pgpool_logs:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /data/pgsql/pgpool/logs

3.2.注释

environment:
  - PGPOOL_BACKEND_NODES=0:pg-0:5432,1:pg-1:5433,2:pg-2:5434           # 定义后端PostgreSQL节点列表（格式：ID:主机名:端口）
  - PGPOOL_SR_CHECK_USER=postgres                                       # 流复制检查用户名（用于监控复制状态）
  - PGPOOL_SR_CHECK_PASSWORD=postgres                                   # 流复制检查用户的密码
  - PGPOOL_ENABLE_LDAP=no                                               # 禁用LDAP认证（使用数据库认证）
  - PGPOOL_POSTGRES_USERNAME=postgres                                   # Pgpool连接PostgreSQL的用户名
  - PGPOOL_POSTGRES_PASSWORD=postgres                                   # Pgpool连接PostgreSQL的密码
  - PGPOOL_ADMIN_USERNAME=postgres                                      # Pgpool管理界面用户名
  - PGPOOL_ADMIN_PASSWORD=postgres                                      # Pgpool管理界面密码

启动

cd /root/pg_ha_cluster/pgpool &&  docker-compose up -d

查看集群状态

[root@vm-centos7-181 ~]# docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep pg
pgpool             Up 25 minutes          0.0.0.0:9996->5432/tcp, :::9996->5432/tcp
pg-2               Up About an hour       0.0.0.0:5434->5432/tcp, :::5434->5432/tcp
pg-1               Up About an hour       0.0.0.0:5433->5432/tcp, :::5433->5432/tcp
pg-0               Up About an hour       0.0.0.0:5432->5432/tcp, :::5432->5432/tcp

4.主从复制验证

在pgpool中创建表，最后所有pg包括pgpool都有表创建。已验证成功。

2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

阿里Agentic AI架构师亲授：上下文工程如何让智能体更懂用户

上下文工程（Context Engineering）是系统性设计、管理、优化智能体“上下文信息”的工程方法准确识别用户的当前需求（比如“买生日礼物”）；结合用户的历史行为（比如“去年买过真丝围巾”）；适配环境场景（比如“北方冬季需要保暖”）；保持对话一致性（比如“不推荐之前说过的鲜艳颜色”）；最终生成“贴合用户意图”的回答。阿里的智能体在早期遇到过“一致性问题”：比如之前说“妈妈喜欢素雅风格”，后

2048 AI社区

联邦学习如何重塑AI原生应用格局

本文旨在全面解析联邦学习技术及其对AI原生应用生态的影响。我们将覆盖从基础概念到前沿应用的完整知识体系，帮助读者理解这一革命性技术如何在不共享原始数据的情况下实现多方协作的机器学习。核心概念与联系：解释联邦学习的基本原理和架构核心算法原理：深入分析联邦平均算法(FedAvg)等关键技术项目实战：通过代码示例展示联邦学习的实现应用场景：探讨联邦学习在各行业的实际应用未来展望：分析技术发展趋势和挑战联

2048 AI社区

Linux操作系统-进程的“夺舍”：程序替换如何清空内存、注入新魂?

这里我们要用到main函数的参数argv，也就是我们之前讲过的命令行参数，我们让arg指针指向argv的第二个数据，因为第一个数据是我们要执行的文件，后面才是要怎么执行，并将argv的第一个数据传给execv的第一个参数，之后将arg指向的从下标为1开始的数组传给第二个参数。这里我以execvpe为例，我们这次让子进程来执行我们自己写的程序，程序的内容就是打印出命令行参数和环境变量，程序的结果我们