replSetInitiate

定义

replSetInitiate

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

提示

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

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

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

注意

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

语法

该命令具有以下语法：

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

<config_document>是指定副本集配置的文档。例如，以下是用于创建简单3节点副本集的配置文档：

{
    _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设置。