Docker搭建PostgreSQL一主二从架构

前提条件

3台服务器并安装Docker

配置PostgreSQL主节点

远程连接PostgreSQL主节点，依次运行以下命令，安装PostgreSQL。

输入mkdir postgresql命令，创建postgresql文件夹。
输入cd postgresql命令，进入postgresql文件夹。

输入vim docker-compose.yml命令，并将以下内容写入，创建docker-compose.yml文件。

 version: '3.1'
 services:
   postgres:
     image: postgres:16.1
     container_name: postgresql
     restart: always
     environment:
       - POSTGRES_DB=postgres
       - POSTGRES_USER=postgres
       - POSTGRES_PASSWORD=<数据库密码>
       - TZ=Asia/Shanghai
     volumes:
       - ./data/:/var/lib/postgresql/data
     ports:
       - "5432:5432"

输入docker-compose up -d命令，启动PostgreSQL。

在主节点上创建数据库账号replica（用于主从复制），并设置密码及登录权限和备份权限。
1. 输入命令docker exec -it postgresql bash，进入postgresql容器。
2. 输入命令su - postgres，登录postgres用户。
3. 输入psql命令进入PostgreSQL交互终端，当显示postgres=#时表示成功进入交互终端。
4. 输入以下SQL语句创建数据库账号replica，并设置密码及登录权限和备份权限。
```
 CREATE ROLE replica login replication encrypted password '<备份账户密码>';
```
5. 输入以下SQL语句查询账号是否创建成功。返回记录包含replica，表示已创建成功。
```
 SELECT usename from pg_user;
```
6. 终端输入\q，退出SQL终端。输入exit命令，退出postgres用户，再输入exit命令，退出容器。

修改创建的postgresql文件夹下data文件中pg_hba.conf文件，检查并设置replica用户白名单，允许从节点密码认证连接和允许用户从replication数据库进行数据同步。

 host    all             all             all                     scram-sha-256  #允许用户密码认证连接
 host    replication     all             all                     scram-sha-256  #允许用户从replication数据库进行同步

修改创建的postgresql文件夹下data文件中postgresql.conf文件，分别找到以下参数，并将参数修改为以下内容。

 listen_addresses = '*'   #监听的IP地址
 wal_level = replica      #启用热备模式
 max_wal_senders = 10     #同步最大的进程数量
 wal_sender_timeout = 60s #流复制主机发送数据的超时时间
 max_connections = 100    #最大连接数，从库的max_connections必须要大于主库的
 # 注意，如果配置同步复制，建议是一主二从，防止从库同步异常导致主库hang住。
 synchronous_commit = on  #开启同步复制
 synchronous_standby_names = 'ANY 1 (slave1, slave2)' 
 #只要primary端wal传到任意一台standby并commit就OK，这里填写的是备库primary_conninfo中application_name参数值。

运行docker restart postgresql命令，重启服务。

配置PostgreSQL从节点

远程连接PostgreSQL从节点1，同上PostgreSQL主节点安装操作，安装PostgreSQL。
使用pg_basebackup基础备份工具指定备份目录（注意：备份后主节点不可进行任何操作，直到验证从节点正常才可操作主节点）。
1. 输入命令docker exec -it postgresql bash，进入postgresql容器。
2. 进入 /var/lib/postgresql/data 目录，在目录下创建 data_new 文件夹
3. 运行以下命令，使用pg_basebackup基础备份工具指定备份目录。
```
 pg_basebackup -h <主节点ip> -p 5432 -U replica -D <保存路径> -X stream -P -R
```
  注意：-R选项用于创建用于replication的配置文件，生成$PGDATA/standby.signal文件，该文件必须存在，用来标识这是一个备库。
4. 输入exit命令，退出容器。

修改创建的postgresql文件夹下data文件夹下data_new文件夹中postgresql.conf文件，分别找到以下参数，并将参数修改为以下内容。

 recovery_target_timeline = 'latest' #流复制同步到最新的数据
 max_connections = 1000             # 最大连接数，从节点需设置比主节点大
 hot_standby = on                   # 开启热备
 max_standby_streaming_delay = 30s  # 数据流备份的最大延迟时间
 wal_receiver_status_interval = 1s  # 从节点向主节点报告自身状态的最长间隔时间
 hot_standby_feedback = on          # 如果有错误的数据复制向主进行反馈

修改创建的postgresql文件夹下data文件夹下data_new文件夹中postgresql.auto.conf文件，在 primary_conninfo 参数配置添加application_name=slave1。
```
 primary_conninfo = '******** application_name=slave1'
```
输入命令，将data_new文件夹中内容替换创建的postgresql文件夹下data文件夹内容。
运行docker restart postgresql命令，重启服务。
远程连接PostgreSQL从节点2，重复从节点1操作（将slave1改为slave2）。

检测验证

在主节点中进入PostgreSQL交互终端，输入以下SQL语句，在主库中查看从库状态。

运行以下命令，登录postgres用户。
```
 su - postgres
```
输入psql命令进入PostgreSQL交互终端，当显示postgres=#时表示成功进入交互终端。
运行以下命令，在主库中查看从库状态，返回结果如下图，表示可成功查看到从库状态。
```
 select * from pg_stat_replication;
```
终端输入\q，并按Enter退出SQL终端。输入exit命令，并按Enter退出PostgreSQL。

前提条件

配置PostgreSQL主节点

配置PostgreSQL从节点

检测验证

CATALOG