replSetInitiate

定义

replSetInitiate

replSetInitiate命令会初始化一个新的副本集。

提示

在mongosh中，该命令也运行通过 rs.initiate()辅助方法运行。

辅助方法对 mongosh 用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。

要运行 replSetInitiate，请使用 db.runCommand( { <command> } ) 方法。

注意

仅在副本集的其中一个 mongod 实例上运行命令。

兼容性

此命令可用于以下环境中托管的部署：

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
   {
     replSetInitiate : <config_document>
   }
)

<config_document> 是指定副本集配置的文档。例如，下面是一个用于创建简单 3-member 副本集的配置文档：

{
    _id : <setname>,
     members : [
         {_id : 0, host : <host0>},
         {_id : 1, host : <host1>},
         {_id : 2, host : <host2>},
     ]
}

IP 绑定

MongoDB 二进制文件 mongod 和 mongos 默认绑定到本地主机。如果为此二进制文件设置了 net.ipv6 配置文件设置或 --ipv6 命令行选项，则该二进制文件还会绑定到本地主机 IPv6 地址。

默认情况下，绑定到本地主机的 mongod 和 mongos 只接受来自同一计算机上运行的客户端的连接。这种绑定行为包括 mongosh 和副本集或分片集群的其他节点。远程客户端无法连接到仅绑定到本地主机的二进制文件。

要覆盖默认绑定并绑定到其他 IP 地址，请使用 net.bindIp 配置文件设置或 --bind_ip 命令行选项来指定主机名或 IP 地址的列表。

例如，以下 mongod 实例会绑定到本地主机和主机名 My-Example-Associated-Hostname，而该主机名与 IP 地址 198.51.100.1 相关联：

mongod --bind_ip localhost,My-Example-Associated-Hostname

为了连接到此实例，远程客户端必须指定主机名或其关联的 IP 地址 198.51.100.1：

mongosh --host My-Example-Associated-Hostname
mongosh --host 198.51.100.1

例子

将配置文档分配给变量，然后将该文档传递给 rs.initiate() 助手：

config = {
    _id : "my_replica_set",
     members : [
         {_id : 0, host : "rs1.example.net:27017"},
         {_id : 1, host : "rs2.example.net:27017"},
         {_id : 2, host : "rs3.example.net", arbiterOnly: true},
     ]
}
rs.initiate(config)

请注意，省略端口会导致主机使用默认端口 27017。另请注意，您可以在配置文档中指定其他选项，例如本示例中的 arbiterOnly 设置。