更改自托管副本集中的主机名

先决条件

下面的流程会读取并更新local数据库中的system.replset集合。

若部署启用了访问控制，执行操作的用户必须对system.replset集合拥有find和update权限动作。

按以下步骤创建提供必要权限的角色：

1. 使用有权管理用户和角色的用户登录，例如具备userAdminAnyDatabase角色的用户。以下流程使用在自托管部署中启用访问控制一文创建的myUserAdmin。

   mongosh --port 27017 -u myUserAdmin --authenticationDatabase 'admin' -p

2. 创建用户角色，授予它对local数据库中system.replset集合的必要权限：

   db.adminCommand( {   createRole: "systemreplsetRole",   privileges: [      { resource: { db: "local", collection: "system.replset" }, actions: ["find","update"] }   ],   roles: []} );

3. 将角色授予执行重命名的用户。例如，下面假定admin数据库中已存在userPerformingRename用户。

   use admindb.grantRolesToUser( "userPerformingRename", [ { role: "systemreplsetRole", db: "admin" } ] );

操作流程

1. 停止副本集的所有成员。

2. 在不同端口上重启每个成员，并且不使用–replSet运行时选项。维护期间更改端口，可以防止客户端连接此主机。仍使用成员原来的–dbpath，本例为/data/db1。命令形式如下：

   警告

   将实例绑定到可公开访问的IP地址之前，必须保护集群，防止未授权访问。完整建议见自托管部署安全检查清单。至少应考虑启用身份验证并加固网络基础设施。

   mongod --dbpath /data/db1/ --port 37017 --bind_ip localhost,<hostname(s)|ip address(es)>

   重要

   为避免IP变化导致配置更新，应使用DNS主机名而非IP地址。配置副本集成员或分片集群成员时尤其如此。

   在具有分割网络视图的环境中，应使用主机名配置集群。从MongoDB 5.0开始，仅配置IP地址的节点无法通过启动校验，也不会启动。

3. 对副本集每个成员依次执行：

   1. 使用mongosh连接运行在新临时端口上的mongod。例如，临时端口为37017时，运行：

      mongosh --port 37017

      若启用了访问控制，使用具有适当权限的用户连接。参见先决条件。

      mongosh --port 37017 -u userPerformingRename --authenticationDatabase=admin  -p

   2. 手动编辑副本集配置。它是local数据库中system.replset集合的唯一文档。

      在配置中为所有成员填写新主机名与端口。

      1. 切换到local数据库。

         use local

      2. 用JavaScript变量保存配置文档。将_id字段的值改为实际副本集名称。

         cfg = db.system.replset.findOne( { "_id": "rs0" } )

      3. 为每个成员提供新主机名和端口；应改成当前副本集的实际值。

         cfg.members[0].host = "mongodb0.example.net:27017"cfg.members[1].host = "mongodb1.example.net:27017"cfg.members[2].host = "mongodb2.example.net:27017"

      4. 更新system.replset集合中的主机名和端口：

         db.system.replset.updateOne( { "_id": "rs0" }, { $set: cfg } )

      5. 核实更改：

         db.system.replset.find( {}, { "members.host": 1 } )

   3. 停止该成员上的mongod进程。

4. 完成所有成员的重新配置后，以正常方式启动各mongod实例：使用通常的端口号，并加上–replSet选项。例如：

   警告

   将实例绑定到可公开访问的IP地址之前，必须保护集群，防止未授权访问。完整建议见自托管部署安全检查清单。至少应考虑启用身份验证并加固网络基础设施。

   mongod --dbpath /data/db1/ --port 27017 --replSet rs0 --bind_ip localhost,<hostname(s)|ip address(es)>

5. 使用mongosh连接其中一个mongod实例。例如：

   mongosh --port 27017

6. 在mongosh中调用rs.conf()确认新配置。

   输出应类似：

   {    "_id" : "rs0",    "version" : 4,    "members" : [        {            "_id" : 0,            "host" : "mongodb0.example.net:27017"        },        {            "_id" : 1,            "host" : "mongodb1.example.net:27017"        },        {            "_id" : 2,            "host" : "mongodb2.example.net:27017"        }    ]}