Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
数据库命令
/
复制

replSetInitiate

在此页面上

  • 兼容性
  • 语法
  • IP 绑定
  • 例子
replSetInitiate

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

提示

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

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

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

注意

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

兼容性

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

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

重要

M 0 、M 2 、M 5和 M 10 + 集群不支持此命令。 有关更多信息，请参阅不支持的命令。

语法

该命令具有以下语法：

{ replSetInitiate : <config_document> }

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

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

重要

要避免因 IP 地址变更而更新配置，请使用 DNS 主机名而非 IP 地址。在配置副本集成员或分片集群成员时，使用 DNS 主机名而非 IP 地址尤为重要。

在水平分割网络配置下，请使用主机名而非 IP 地址来配置集群。从 MongoDB 5.0 开始，仅配置了 IP 地址的节点将无法通过启动验证，因而不会启动。

IP 绑定

警告

在绑定到非本地主机（例如 可公开访问的） IP解决，确保已保护集群免遭未经授权的访问权限。 有关安全建议的完整列表，请参阅自托管部署的安全检查清单。 至少应考虑启用身份验证并强化网络基础架构。

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

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

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

警告

从 MongDB5.0 开始， 水平分割 DNS 仅配置了 IP 地址的节点无法启动验证并报告错误。请参阅disableSplitHorizonIPCheck 。

例如，以下 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)

重要

要避免因 IP 地址变更而更新配置，请使用 DNS 主机名而非 IP 地址。在配置副本集成员或分片集群成员时，使用 DNS 主机名而非 IP 地址尤为重要。

在水平分割网络配置下，请使用主机名而非 IP 地址来配置集群。从 MongoDB 5.0 开始，仅配置了 IP 地址的节点将无法通过启动验证，因而不会启动。

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

提示

另请参阅：

后退

replSetGetStatus

来年

replSetMaintenance