rs.initiate()

Description描述

rs.initiate(configuration)

Initiates a replica set. 启动复制副本集。Optionally, the method can take an argument in the form of a document that holds the configuration of a replica set.可选地，该方法可以采用文档形式的参数，该文档包含副本集的配置。

Important

mongosh Method

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

For the database command, see the replSetInitiate command.有关数据库命令，请参阅replSetInitiate命令。

For MongoDB API drivers, refer to the language-specific MongoDB driver documentation.有关MongoDB API驱动程序，请参阅特定语言的MongoDB驱动程序文档。

For the legacy mongo shell documentation, refer to the documentation for the corresponding MongoDB Server release:对于遗留的mongoshell文档，请参阅相应MongoDB Server版本的文档：

mongo shell v4.4

The rs.initiate() method has the following parameter:rs.initiate()方法具有以下参数：

Parameter参数	Type类型	Description描述
configuration	document	Optional.可选的。A document that specifies configuration for the new replica set. 指定新复制副本集配置的文档。If a configuration is not specified, MongoDB uses a default replica set configuration.如果没有指定配置，MongoDB将使用默认的副本集配置。

IP BindingIP绑定

MongoDB binaries, mongod and mongos, bind to localhost by default. MongoDB二进制文件mongod和mongos默认绑定到localhost。If the net.ipv6 configuration file setting or the --ipv6 command line option is set for the binary, the binary additionally binds to the localhost IPv6 address.如果为二进制文件设置了net.ipv6配置文件设置或--ipv6命令行选项，则二进制文件将额外绑定到localhost ipv6地址。

By default mongod and mongos that are bound to localhost only accept connections from clients that are running on the same computer. 默认情况下，绑定到localhost的mongod和mongos只接受来自在同一台计算机上运行的客户端的连接。This binding behavior includes mongosh and other members of your replica set or sharded cluster. 这种绑定行为包括mongosh和复制集或分片集群的其他成员。Remote clients cannot connect to binaries that are bound only to localhost.远程客户端无法连接到仅绑定到localhost的二进制文件。

To override the default binding and bind to other IP addresses, use the net.bindIp configuration file setting or the --bind_ip command-line option to specify a list of hostnames or IP addresses.要覆盖默认绑定并绑定到其他IP地址，请使用net.bindIp配置文件设置或--bind_ip命令行选项指定主机名或IP地址列表。

For example, the following mongod instance binds to both the localhost and the hostname My-Example-Associated-Hostname, which is associated with the IP address 198.51.100.1:例如，以下mongod实例绑定到localhost和主机名My-Example-Associated-Hostname，后者与IP地址198.51.100.1关联：

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

In order to connect to this instance, remote clients must specify the hostname or its associated IP address 198.51.100.1:为了连接到此实例，远程客户端必须指定主机名或其关联的IP地址198.51.100.1：

mongosh --host My-Example-Associated-Hostname

mongosh --host 198.51.100.1

Replica Set Configuration副本集配置

See Replica Set Configuration Document Example for details of the replica set configuration document.有关副本集配置文档的详细信息，请参阅副本集配置文件示例。

Example实例

The following example initiates a new replica set with three members.以下示例启动一个包含三个成员的新复制副本集。

The three mongod instances must have started with the --replSet command line option (or replication.replSetName if using a configuration file) set to myReplSet and the --bind_ip (or net.bindIp if using a configuration file) set appropriately such that other members of the replica set and clients can connect.三个mongod实例必须在启动时将--replSet命令行选项（如果使用配置文件，则为replication.replSetName）设置为myReplSet，并适当设置--bind_ip（如果使用了配置文件，请为net.bindIp），以便副本集的其他成员和客户端可以连接。

Connect mongosh to one of the mongod instances and run rs.initiate().将mongosh连接到其中一个mongod实例，然后运行rs.initiate()。

rs.initiate(
   {
      _id: "myReplSet",
      version: 1,
      members: [
         { _id: 0, host : "mongodb0.example.net:27017" },
         { _id: 1, host : "mongodb1.example.net:27017" },
         { _id: 2, host : "mongodb2.example.net:27017" }
      ]
   }
)

For details on replica set configuration, see Replica Set Configuration Fields.有关副本集配置的详细信息，请参阅副本集配置字段。

For details on deploying a replica set, see Deploy a Replica Set.有关部署副本集的详细信息，请参阅部署副本集。