使用 Bitnami PostgreSQL Docker 镜像快速设置流复制集群

虚幻大学 xuhss 543℃ 0评论

? 优质资源分享 ?

学习路线指引(点击解锁) 知识定位 人群定位
? Python实战微信订餐小程序 ? 进阶级 本课程是python flask+微信小程序的完美结合,从项目搭建到腾讯云部署上线,打造一个全栈订餐系统。
?Python量化交易实战? 入门级 手把手带你打造一个易扩展、更安全、效率更高的量化交易系统

525f223ab16dca1721e7f6f9a7b6f080 - 使用 Bitnami PostgreSQL Docker 镜像快速设置流复制集群

bitnami-docker-postgresql 仓库

源码:bitnami-docker-postgresql

流复制相关环境变量

使用以下环境变量,可以使用 Bitnami PostgreSQL Docker 镜像 轻松设置流复制集群:

  • POSTGRESQL_REPLICATION_MODE: replication 模式。可能的值 master/slave。没有默认值。
  • POSTGRESQL_REPLICATION_USER: 首次运行时在主服务器上创建的 replication 用户。没有默认值。
  • POSTGRESQL_REPLICATION_PASSWORD: replication 用户密码。 没有默认值。
  • POSTGRESQL_REPLICATION_PASSWORD_FILE: 包含 replication 用户密码的文件的路径。这将覆盖 POSTGRESQL_REPLICATION_PASSWORD 中指定的值。没有默认值。
  • POSTGRESQL_MASTER_HOST: replication master(slave 参数)Hostname/IP。没有默认值。
  • POSTGRESQL_MASTER_PORT_NUMBER: replication master 的服务器端口(slave 参数)。默认是 5432

复制(replication)集群中,您可以拥有一个主(master)服务器和零个或多个从(slave)服务器。 启用复制后,master 节点处于读写模式,而 slave 节点处于只读模式。 为了获得最佳性能,建议将读取限制在 slave 上。

第 1 步:创建 replication master

第一步是启动 master。

$ docker run --name postgresql-master \
 -e POSTGRESQL\_REPLICATION\_MODE=master \
 -e POSTGRESQL\_USERNAME=my\_user \
 -e POSTGRESQL\_PASSWORD=password123 \
 -e POSTGRESQL\_DATABASE=my\_database \
 -e POSTGRESQL\_REPLICATION\_USER=my\_repl\_user \
 -e POSTGRESQL\_REPLICATION\_PASSWORD=my\_repl\_password \
 bitnami/postgresql:latest

在此命令中,我们使用 POSTGRESQL_REPLICATION_MODE=master 参数将容器配置为 master 容器。使用 POSTGRESQL_REPLICATION_USERPOSTGRESQL_REPLICATION_PASSWORD 参数指定 replication 用户。

步骤 2:创建 replication slave

接下来我们启动一个 replication slave 容器。

$ docker run --name postgresql-slave \
 --link postgresql-master:master \
 -e POSTGRESQL\_REPLICATION\_MODE=slave \
 -e POSTGRESQL\_MASTER\_HOST=master \
 -e POSTGRESQL\_MASTER\_PORT\_NUMBER=5432 \
 -e POSTGRESQL\_REPLICATION\_USER=my\_repl\_user \
 -e POSTGRESQL\_REPLICATION\_PASSWORD=my\_repl\_password \
 bitnami/postgresql:latest

在上面的命令中,使用 POSTGRESQL_REPLICATION_MODE 参数将容器配置为slave。 在 replication slave 启动之前,slave 容器使用 POSTGRESQL_MASTER_HOSTPOSTGRESQL_MASTER_PORT_NUMBER 参数连接到 master 并从 master 复制初始数据库。POSTGRESQL_REPLICATION_USERPOSTGRESQL_REPLICATION_PASSWORD 凭证用于向 master 进行身份验证。为了改变 pg_hba.conf 的默认设置,slave 需要知道是否设置了 POSTGRESQL_PASSWORD

使用这两个命令,您现在可以启动并运行一个两节点 PostgreSQL 主从(master-slave)流复制集群。 您可以通过添加/删除从(slave)服务器来扩展集群,而不会导致任何停机。

Note: 集群完整地复制 master 服务器,包括所有用户和数据库。

如果 master 服务器宕机,您可以重新配置一个 slave 服务器作为 master 服务器并通过创建触发器文件 /tmp/postgresql.trigger.5432 开始接受写入。例如,以下命令将 postgresql-slave 重新配置为 master 服务器:

$ docker exec postgresql-slave touch /tmp/postgresql.trigger.5432

Note: 需要更新集群中其他 slave 服务器的配置,以便他们知道新的 master 服务器。这将要求您根据我们的示例使用 --link postgresql-slave:master 重新启动其他 slave 服务器。

使用 Docker Compose,可以使用以下方式设置主从复制:

version: '2'

services:
  postgresql-master:
    image: 'bitnami/postgresql:latest'
    ports:
      - '5432'
    volumes:
      - 'postgresql\_master\_data:/bitnami/postgresql'
    environment:
      - POSTGRESQL\_REPLICATION\_MODE=master
      - POSTGRESQL\_REPLICATION\_USER=repl\_user
      - POSTGRESQL\_REPLICATION\_PASSWORD=repl\_password
      - POSTGRESQL\_USERNAME=my\_user
      - POSTGRESQL\_PASSWORD=my\_password
      - POSTGRESQL\_DATABASE=my\_database
  postgresql-slave:
    image: 'bitnami/postgresql:latest'
    ports:
      - '5432'
    depends\_on:
      - postgresql-master
    environment:
      - POSTGRESQL\_REPLICATION\_MODE=slave
      - POSTGRESQL\_REPLICATION\_USER=repl\_user
      - POSTGRESQL\_REPLICATION\_PASSWORD=repl\_password
      - POSTGRESQL\_MASTER\_HOST=postgresql-master
      - POSTGRESQL\_PASSWORD=my\_password
      - POSTGRESQL\_MASTER\_PORT\_NUMBER=5432

volumes:
  postgresql\_master\_data:

使用以下方法缩放 slave 的数量:

$ docker-compose up --detach --scale postgresql-master=1 --scale postgresql-slave=3

上面的命令将 slave 的数量增加到 3。你可以用同样的方法缩小。

Note: 您不应该扩大/缩小主节点的数量。始终只运行一个主节点。

同步提交

默认情况下,slave 实例配置为异步复制。为了保证更高的数据稳定性(以牺牲一些性能为代价),可以使用以下环境变量设置同步提交(即,在将事务提交写入一组副本之前,事务提交不会将成功返回给客户端)。

使用 Docker Compose,可以按如下方式设置带有同步提交的主从复制:

version: '2'

services:
  postgresql-master:
    image: 'bitnami/postgresql:latest'
    ports:
      - '5432'
    volumes:
      - 'postgresql\_master\_data:/bitnami/postgresql'
    environment:
      - POSTGRESQL\_REPLICATION\_MODE=master
      - POSTGRESQL\_REPLICATION\_USER=repl\_user
      - POSTGRESQL\_REPLICATION\_PASSWORD=repl\_password
      - POSTGRESQL\_USERNAME=my\_user
      - POSTGRESQL\_PASSWORD=my\_password
      - POSTGRESQL\_DATABASE=my\_database
      - POSTGRESQL\_SYNCHRONOUS\_COMMIT\_MODE=on
      - POSTGRESQL\_NUM\_SYNCHRONOUS\_REPLICAS=1
    volumes:
      - '/path/to/postgresql-persistence:/bitnami/postgresql'
  postgresql-slave:
    image: 'bitnami/postgresql:latest'
    ports:
      - '5432'
    depends\_on:
      - postgresql-master
    environment:
      - POSTGRESQL\_REPLICATION\_MODE=slave
      - POSTGRESQL\_REPLICATION\_USER=repl\_user
      - POSTGRESQL\_REPLICATION\_PASSWORD=repl\_password
      - POSTGRESQL\_MASTER\_HOST=postgresql-master
      - POSTGRESQL\_MASTER\_PORT\_NUMBER=5432
  postgresql-slave2:
    image: 'bitnami/postgresql:latest'
    ports:
      - '5432'
    depends\_on:
      - postgresql-master
    environment:
      - POSTGRESQL\_REPLICATION\_MODE=slave
      - POSTGRESQL\_REPLICATION\_USER=repl\_user
      - POSTGRESQL\_REPLICATION\_PASSWORD=repl\_password
      - POSTGRESQL\_MASTER\_HOST=postgresql-master
      - POSTGRESQL\_MASTER\_PORT\_NUMBER=5432

在上面的示例中,提交需要同时写入主服务器和其中一个从服务器才能被接受。另一个 slave 将继续使用异步复制。使用以下 SQL 查询对其进行检查:

postgres=# select application_name as server, state,
postgres-#  sync\_priority as priority, sync\_state
postgres-#  from pg\_stat\_replication;
| server      | state     | priority | sync_state |
|-------------|-----------|----------|------------|
| walreceiver | streaming | 0        | sync       |
| walreceiver | streaming | 0        | async      |

Note: 对于更高级的设置,您可以通过设置 POSTGRESQL_CLUSTER_APP_NAME 环境变量,使用 application_name 参数定义不同的复制组。

更多

转载请注明:xuhss » 使用 Bitnami PostgreSQL Docker 镜像快速设置流复制集群

喜欢 (0)

您必须 登录 才能发表评论!