percona/percona-clustersync-mongodb

Percona ClusterSync for MongoDB (PCSM)

镜像概述和主要用途

Percona ClusterSync for MongoDB (PCSM) 是一个开源二进制进程，可在MongoDB部署之间实时复制数据，直至手动终止。同时支持从源到目标的一次性零停机数据迁移，适用于MongoDB集群间的数据同步与迁移场景。

核心功能和特性

• 数据克隆：将现有数据从源MongoDB传输到目标MongoDB部署
• 实时复制：利用MongoDB https://mongodb.com/docs/manual/changeStreams/ 跟踪源集群的变更并实时复制到目标
• 命名空间过滤：指定要包含或排除的数据库和集合
• 自动索引管理：确保在目标端创建必要的索引
• HTTP API：通过HTTP端点执行启动、终止、暂停、恢复复制及检查状态等操作

支持的MongoDB拓扑

• 副本集到副本集：源和目标副本集可具有不同的节点数量
• 分片集群到分片集群：源和目标分片集群可具有不同的分片数量

MongoDB版本要求

• 支持在相同主版本内同步Percona Server for MongoDB或MongoDB Community/Enterprise Advanced/Atlas，包括6.0到6.0、7.0到7.0、8.0到8.0
• 最低支持的MongoDB版本：6.0.17、7.0.13、8.0.0

Percona ClusterSync for MongoDB Docker镜像

Percona ClusterSync for MongoDB Docker镜像由Percona团队创建和维护，会在新发布时更新。

使用方法和配置说明

前提条件

1. 需部署MongoDB或Percona Server for MongoDB作为源和目标集群，或使用现有部署。集群可运行在Docker容器、虚拟机或云环境中。

2. PCSM容器必须能够通过网络访问源和目标MongoDB集群的所有节点，包括：

   • 所有可能成为主节点的副本集成员
   • 源和目标集群中的mongos节点

3. 在源和目标集群中创建具有适当权限的用户进行身份验证。示例命令：

   bash
   db.getSiblingDB("admin").createUser({
     user: "source",
     pwd: "mys3cretpAss",
     roles: ["backup", "clusterMonitor", "readAnyDatabase"]
   });
   

4. 源集群需有数据以验证复制功能。

启动Percona ClusterSync for MongoDB

可通过环境变量或命令行标志指定连接字符串启动PCSM容器：

使用环境变量

bash
docker run --name <container-name> --network <mymongo> -d \
-e PCSM_SOURCE_URI="mongodb://<source-user>:<source-password>@psmdb-source:27017" \
-e PCSM_TARGET_URI="mongodb://<target-user>:<target-password>@psmdb-target:27017" \
docker.xuanyuan.run/percona/percona-clustersync-mongodb:<tag>

使用命令行标志

bash
docker run --name <container-name> --network <mymongo> \ 
-d docker.xuanyuan.run/percona/percona-clustersync-mongodb:<tag> \
--source "mongodb://<source-user>:<source-password>@psmdb-source:27017" \
--target "mongodb://<target-user>:<target-password>@psmdb-target:27017"

参数说明：

• container-name：分配给容器的名称
• PCSM_SOURCE_URI/--source 和 PCSM_TARGET_URI/--target：用于连接源和目标MongoDB集群的https://docs.mongodb.com/manual/reference/connection-string/
• mymongo（可选）：若源和目标集群在Docker中部署，此为它们运行的网络
• tag：指定所需版本和架构的标签，可查看https://hub.docker.com/repository/registry-1.docker.io/percona/percona-clustersync-mongodb/tags/

检查初始状态

替换<container-name>为容器名称，执行：

bash
docker exec -it <container-name> pcsm status

状态应为idle，表示PCSM已准备好接受请求。

运行Percona ClusterSync for MongoDB

以下命令中，将pcsm1替换为您的容器名称：

1. 启动复制进程：

   bash
   docker exec -it pcsm1 pcsm start
   

2. 检查复制状态以进行监控：

   bash
   docker exec -it pcsm1 pcsm status
   

3. 查看日志以监控活动：

   bash
   docker logs -f pcsm1
   

用户反馈

我们欢迎您的反馈！

更多信息和相关下载，请访问 [***]
https://docs.percona.com/percona-clustersync-for-mongodb/