PostgreSql Docker 主从热备，异步流复制方案

环境说明

1. Docker
2. Windows 11
3. PostgreSql 16

方案步骤

0. 宿主机准备：

1. 找个地方创建一个文件夹用来挂载容器中数据库Data文件夹，这里我用的是：
   C:\Users\Administrator\docker\Postgresql\replication

1. 主数据库准备：

1. 执行docker run 命令，创建主数据库容器：pgsmaster

docker run --name pgsmaster -p 5400:5432 -e POSTGRES_PASSWORD=123456 -v C:\Users\Administrator\docker\Postgresql\replication\pgsmaster:/var/lib/postgresql/data -d postgres

2. 添加复制角色用户：

# 1.进入容器 
docker exec -it pgsmaster bash 
# 2.连接PostgreSQL 
psql -U postgres 
# 3.创建用户 
// replicator: 复制账号; 123456: 认证密码 
create role replicator login replication encrypted password '123456'; 
# 4.验证用户 
\du
# 出现如下列表则用户创建成功
List of roles 
Role name | Attributes 
-----------+-------------------------------------------
postgres | Superuser, Create role, Create DB, Replication, Bypass RLS 
replicator | Replication

3. 关闭容器：Docker stop pgsmaster

4. 宿主机找到挂载文件夹：C:\Users\Administrator\docker\Postgresql\replication\pgsmaster 下的 postgresql.conf 文件，修改配置：

   1. listen_addresses ='*'
   2. wal_log_hints = on
   3. wal_level = replica
   

5. 找到 pg_hba.conf 文件，最后一行添加配置：

	host replication replicator 172.17.0.0/16 md5

7. 启动容器：Docker start pgsmaster

到这里主数据库就准备好了~

2. 从数据库准备：

1. 同样执行docker run 命令，创建一个从数据库容器：

docker run --name pgsslave -p 5401:5432 -e POSTGRES_PASSWORD=123456 -v C:\Users\Administrator\docker\Postgresql\replication\pgsslave:/var/lib/postgresql/data -d postgres

2. 到宿主机挂在文件夹C:\Users\Administrator\docker\Postgresql\replication\pgsslave下创建一个tempdata文件夹

3. 进入容器，进行主库复制：

	# 1. 进入容器
	docker exec -it pgsslave bash
	# 2. 切换postgres用户
	su postgres
	# 3. 执行复制, 注意IP, 需要输入密码即主数据库创建复制用户replicator的密码‘123456’
	pg_basebackup -h 172.17.0.6 -U replicator -D /var/lib/postgresql/data/tempdata -X stream -P

4. 关闭从数据库容器：
   docker stop pgsslave

5. 进入宿主机挂在文件夹下的tempdata文件夹下，将所文件夹下的所有文件覆盖到上级文件夹，并进入上级文件夹，我这里是：C:\Users\Administrator\docker\Postgresql\replication\pgsslave；

6. 修改 postgresql.conf 文件参数：

	1. primary_conninfo = 'host=172.17.0.6 port=5432 user=replicator password=123456' # 配置连接主数据库，注意IP和端口号
	2. hot_standby = on # 说明这台机器不仅仅是用于数据归档，也用于数据查询
	3. max_standby_streaming_delay = 30s # 数据流备份的最大延迟时间 
	4. wal_receiver_status_interval = 10s # 多久向主报告一次从的状态 
	5. hot_standby_feedback = on # 如果有错误的数据复制，是否向主进行反馈

7. 添加 standby.signal 文件：

	standby_mode = 'on'

8. 启动从数据库：
   docker start pgsslave

到这里从数据库也配置好了~

3. 验证：

1. 进入主数据库容器：
   docker exec -it pgsmaster bash

2. 执行命令：

	psql -U postgres -x -c "select * from pg_stat_replication;"

3. 出现如下信息则表示配置成功~

	-[ RECORD 1 ]----+------------------------------ 
	pid | 65 
	usesysid | 16388 
	usename | replicator 
	application_name | walreceiver 
	client_addr | 172.17.0.7 
	client_hostname | 
	client_port | 56664 
	backend_start | 2024-11-28 05:44:17.805887+00 
	backend_xmin | 743 
	state | streaming 
	sent_lsn | 0/5000148 
	write_lsn | 0/5000148 
	flush_lsn | 0/5000148 
	replay_lsn | 0/5000148 
	write_lag | 
	flush_lag | 
	replay_lag | 
	sync_priority | 0 
	sync_state | async 
	reply_time | 2024-11-28 05:45:57.855411+00

到这里，配置完毕~