详情

首页手游攻略 MongoDB副本集部署实践教程实用指南

MongoDB副本集部署实践教程实用指南

佚名 2026-09-01 18:20:01

平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“MongoDB副本集部署实践教程”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。

一般而言,副本集主要成员有三个:主节点,副本节点,仲裁节点

从实现思路看,按照官方建议方案,我们搭建一个三成员的副本集,这个副本集由一个主结点和两个副本结点组成。

落到代码里,这里采用三台虚拟机进行部署:node1(主节点),node2(副本节点),node3(副本节点)

一、环境准备

理解这一步时,按照跳转文章介绍的方式,分别在三台服务器上新建user-mongo用户,同时将目录/opt/module/,mongodb_dcmo/更改为用户user_mongo的权限,采用该用户进行MongoDB副本集安装与启动
理解这一步时,在三台服务器目录/opt/module/mongodb_demo/下新建目录/replicaset/data/和目录/replicaset/logs/,用来存放MongoDB副本集的数据和MongoDB副本集的日志文件,具体操作命令如下所示:

mkdir replicaset
cd replicaset/
mkdir data
mkdir logs
cd logs
touch mongodb.log

二、副本集的安装与启动

1.安装副本集

在这个场景下,首先在node1上安装好mongodb,借助解压MongoDB安装包的方式安装MongoDB,将MongoDB安装包解压目录/opt/module/mongo_demo/replicaset/下,重命名为mongodb后

实际处理时,replicaset目录下包含data(数据)、logs(日志)和mongodb(MongoDB安装目录)文件夹,同时且这些文件夹的用户权限都是user_mongo.

再将服务器node1中/opt/module/mongodb_demo/replicaset/目录下的所有内容借助scp命令分发到服务器node2和服务器node3上

2.启动副本集

分别在三台服务器node1、node2和node3的/opt/module/mongodb_demo/replicaset/mongodb/bin目录下以副本集模式启动MongoDB,这里以服务器node1为例进行操作

node1:

cd /opt/module/mongodb_demo/replicaset/mongodb/bin

副本集模式启动mongodb:

./mongod --replSet xxx --dbpath=/opt/module/mongodb_demo/replicaset/data/ --logpath=/opt/module/mongodb_demo/replicaset/logs/mongodb.log --port 27017 --bind_ip node1 --logappend --fork

结合项目来看,上述启动MongoDB命令中,参数replSet指定MongoDB副本集名称【xxx-自己命名】,同一副本集须指定相同名称;

  • 结合项目来看,参数dbpath指定MongoDB副本集数据存放目录(不能与其他MongoDB服务冲突);
  • 参数logpath指定MongoDB服务副本集日志目录;
  • 实际处理时,参数port指定MongoDB副本集启动占用的端口号(不能与其他MongoDB冲突);
  • 参数bind_ip开启远程连接,采用当前服务器主机名;
  • 参数logappend指定以追加的方式写入日志;
  • 参数fork指定MongoDB后台启动。

node2:

cd /opt/module/mongodb_demo/replicaset/mongodb/bin
./mongod --replSet itcast --dbpath=/opt/module/mongodb_demo/replicaset/data/ --logpath=/opt/module/mongodb_demo/replicaset/logs/mongodb.log --port 27018 --bind_ip node2 --logappend --fork

node3:

cd /opt/module/mongodb_demo/replicaset/mongodb/bin
./mongod --replSet itcast --dbpath=/opt/module/mongodb_demo/replicaset/data/ --logpath=/opt/module/mongodb_demo/replicaset/logs/mongodb.log --port 27018 --bind_ip node3 --logappend --fork

3.副本集的初始化

登录mongodb客户端:

./mongosh --host node1 --port 27017

这里新版本用的mongosh 老版本用mongo即可

在这个场景下,当出现命令输入提示符>,证明在服务器node1中成功登录MongoDB客户端!
接着在MongoDB客户端中执行副本集初始化操作:

rs.initiate()

接着查看副本集成员状态:

rs.status()

理解这一步时,当前副本集只有一个成员角色,即主结点。下面,我们将其他两台服务器node2和node3中的MongoDB以副本结点的角色添加到副本集中(添加结点的操作必须在主结点
进行),具体命令如下所示:

rs.add("node2:27017")
rs.add("node3:27017")

在这个场景下,执行完添加副本结点命令后,客户端会得到添加的副本结点的相关信息,如信息中字段“OK”的值为1,则证明副本结点添加成功!

理解这一步时,此时,在服务器node2和node3上登录MongoDB客户端,查看当前服务器在副本集中的角色分配情况:

./mongosh --host node2 --port 27017

./mongosh --host node3 --port 27017

4.同步副本文档

理解这一步时,借助向MongoDB副本集主结点写入文档,验证其他副本结点是否成功同步主结点写入的文档内容,具体操作步骤如下所示。
在这个场景下,(1)在服务器node1(副本集主结点)的MongoDB客户端写入一条文档,具体命令如下所示:

结合项目来看,借助上述操作,成功在副本集主结点的数据库test中新建集合user同时插入一条文档。
落到代码里,(2)在服务器node2(副本结点)中登录MongoDB客户端,查看数据库test下的集合user中是否存在与主结点一致的文档内容,具体命令如下所示:

结合项目来看,执行查看集合中的文档命令时,客户端会得到Error的错误信息,这是因为默认情况下
实际处理时,副本结点不能读取副本集中的内容,因此我们需设置开启副本结点的读取权限,随后才可
以查看副本集中的内容,具体命令如下所示:

注:MongoDB 旧版本中,rs.secondaryOk() 用来允许从 secondary 理解这一步时,副本集成员读取数据。但在较新版本(MongoDB 4.2 及以上),官方改进了 读偏好(Read Preference) 机制,建议采用 setReadPref() 来设置读取策略。

db.getMongo().setReadPref("primaryPreferred")

或在 MongoDB shell 连接时直接指定:

mongo --host xxx --readPreference=primaryPreferred

  • "primary":默认值,只从 primary 读取。
  • "secondary":只从 secondary 读取(适用来查询压力大的情况)。
  • "primaryPreferred"优先从 primary 读取从实现思路看,,但如果 primary 不可用,则从 secondary 读取(建议)。
  • "secondaryPreferred":优先从 secondary 读取,primary 不可用时才会采用 primary。
  • "nearest":从最近的节点读取(不考虑 primary/secondary

5.设置副本集成员

1.查看当前副本集设置

首先,您已经采用了 rs.conf() 命令查看了当前的副本集设置,以下是您已经提供的设置内容:cfg = rs.conf();

2.将服务器nosql02由仲裁结点更改为副本结点

修改设置

node2 修改为 仲裁节点arbiterOnly: true,同时且将 priority 设置为 0)。

node3 修改为 延迟节点secondaryDelaySecs: Long("0"),同时且将 priority 设置为 0,hidden 设置为 true)。

cfg.members[1].arbiterOnly = true;               // 将 node2 改为仲裁节点
cfg.members[1].priority = 0; // 设置优先级为 0,避免 node2 成为主节点

提交设置更改

rs.reconfig(cfg);


但由于不允许直接修改节点的 arbiterOnly 字段,需先删除该节点,随后再重新添加它作为仲裁节点。

1.从副本集中删除 node2: 采用 rs.remove() 命令从副本集设置中删除 node2

rs.remove("node2:27017");

2.重新添加 node2 作为仲裁节点: 借助 rs.add() 命令将 node2 以仲裁节点的身份重新添加到副本集中。这里将 arbiterOnly 设置为 true,同时将其优先级设置为 0。

rs.add({ _id: 1, host: "node2:27017", arbiterOnly: true, priority: 0 });

成功成为仲裁节点!

也有别的方法,我没试过,应该莫问题,自己尝试

3.将服务器nosql03中延迟结点修改为正常的副本结点

修改设置:

cfg.members[2].priority = 0;                     // 设置优先级为 0,避免 node3 成为主节点
cfg.members[2].hidden = true; // 将 node3 设置为隐藏节点,确保不会被选为主节点

【注】出现问题解决方法【新版】

错误提示 BSON field 'MemberConfig.slaveDelay' is an unknown field 表示 slaveDelay 这个字段在 MongoDB 设置中是不被识别的,导致 rs.reconfig(cfg) 执行失败。事实上,MongoDB 中同时没有 slaveDelay 字段用来副本集成员的设置。

正确的字段名:

结合项目来看,在 MongoDB 里,应该采用 secondaryDelaySecs 来设置副本集成员的延迟时间,而不是 slaveDelaysecondaryDelaySecs 字段用来设置副本节点相对于主节点的延迟时间,单位是秒。

解决方法:

slaveDelay 更改为 secondaryDelaySecs,同时重新设置副本集:

cfg.members[2].secondaryDelaySecs = 3600; // 设置延迟时间为3600秒

cfg.members[3].priority = 1;  // 设置优先级为 1
cfg.members[3].hidden = false; // 取消隐藏节点
cfg.members[3].secondaryDelaySecs = 0; // 设置延迟为 0 秒

成功了,将服务器nosql03中延迟结点修改为正常的副本结点,即优先级为1,非隐藏和延迟为0秒。

6.安全认证

1.在服务器node3新建新的数据目录和日志文件,以副本集模式启动新的MongoDB,此MongoDB采用27016端口,同时指定keyFile文件。

(1)新建存放keyfile文件的目录,文件写入密钥同时修改权限

mkdir -p /opt/module/mongodb_demo/replicaset/key
touch /opt/module/mongodb_demo/replicaset/key/keyfile
openssl rand -base64 756 -out /opt/module/mongodb_demo/replicaset/key/keyfile
chmod 600 /opt/module/mongodb_demo/replicaset/key/keyfile

(2)同步文件

scp -r /opt/module/mongodb_demo/replicaset/key user_mongo@node1:/opt/module/mongodb_demo/replicaset/
scp -r /opt/module/mongodb_demo/replicaset/key user_mongo@node2:/opt/module/mongodb_demo/replicaset/

(3)新建全局管理用户

登录客户端后,切换到数据库admin,添加全局用户

use admin;
db.createUser({user:"wurui",pwd:"123456",roles:[{role:"userAdminAnyDatabase",db:"admin"},{role:"readWriteAnyDatabase",db:"admin"},{role:"dbAdminAnyDatabase",db:"admin"}]});

验证用户是否新建成功:

执行完上述命令后客户端得到信息“1”,则证明用户新建成功。

在这个场景下,新建新data和新log --我这里命名data103文件和log103文件,log3文件中添加空文件mongo.log

赋予权限:

sudo chown -R user_mongo:user_mongo /opt/module/mongodb_demo/replicaset/data103/
sudo chown -R user_mongo:user_mongob /opt/module/mongodb_demo/replicaset/logs103/

启动安全认证:

./mongod --replSet wurui --keyFile /opt/module/mongodb_demo/replicaset/key/keyfile --dbpath=/opt/module/mongodb_demo/replicaset/data103/ --logpath=/opt/module/mongodb_demo/replicaset/logs103/mongo.log --port 27016 --bind_ip node3 --logappend -fork

node1查看状态:

2.在副本集主结点将服务器node3上新启动的MongoDB以副本结点的形式添加到副本集

主节点中:

rs.add("node3:27016")

出现ok1-->成功成功!

到此这篇关于MongoDB副本集部署完整教程的文章就介绍到这了,更多相关MongoDB副本集部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多兼容脚本之家!

您可能感兴趣的文章:
  • MongoDB副本集部署完整教程(最新建议)
  • 基于docker-compose构建Mongodb副本集的示例详解
  • MongoDB副本集迁移实操案例详解
  • Mongodb副本集和分片示例详解
  • MongoDB副本集丢失数据的测试实例教程
  • CentOS 6.4新建Mongodb副本集
点击查看更多
推荐专题
热门阅读