On this page本页内容
This tutorial describes how to create a three-member replica set from three existing 本教程描述了如何从三个禁用访问控制的现有mongod
instances running with access control disabled.mongod
实例创建一个三成员副本集。
To deploy a replica set with enabled access control, see Deploy Replica Set With Keyfile Authentication. 要部署启用了访问控制的副本集,请参阅使用密钥文件身份验证部署副本集。If you wish to deploy a replica set from a single MongoDB instance, see Convert a Standalone to a Replica Set. 如果希望从单个MongoDB实例部署副本集,请参阅将独立副本集转换为副本集。For more information on replica set deployments, see the Replication and Replica Set Deployment Architectures documentation.有关副本集部署的更多信息,请参阅复制和副本集部署体系结构文档。
Three member replica sets provide enough redundancy to survive most network partitions and other system failures. 三个成员副本集提供了足够的冗余,可以承受大多数网络分区和其他系统故障。These sets also have sufficient capacity for many distributed read operations. 这些集合对于许多分布式读取操作也具有足够的容量。Replica sets should always have an odd number of members. 副本集的成员数应始终为奇数。This ensures that elections will proceed smoothly. 这将确保选举顺利进行。For more about designing replica sets, see the Replication overview.有关设计复制集的更多信息,请参阅复制概述。
For production deployments, you should maintain as much separation between members as possible by hosting the 对于生产部署,您应该通过在不同的机器上托管mongod
instances on separate machines. mongod
实例来尽可能地保持成员之间的隔离。When using virtual machines for production deployments, you should place each 在使用虚拟机进行生产部署时,应将每个mongod
instance on a separate host server serviced by redundant power circuits and redundant network paths.mongod
实例放置在由冗余电源电路和冗余网络路径提供服务的独立主机服务器上。
Before you can deploy a replica set, you must install MongoDB on each system that will be part of your replica set. 在部署副本集之前,必须在将成为副本集一部分的每个系统上安装MongoDB。If you have not already installed MongoDB, see the installation tutorials.如果尚未安装MongoDB,请参阅安装教程。
In production, deploy each member of the replica set to its own machine and if possible bind to the standard MongoDB port of 在生产中,将副本集的每个成员部署到自己的机器上,如果可能,绑定到27017
.27017
的标准MongoDB端口。
See Replica Set Deployment Architectures for more information.有关详细信息,请参阅副本集部署体系结构。
To avoid configuration updates due to IP address changes, use DNS hostnames instead of IP addresses. 为了避免由于IP地址更改而导致的配置更新,请使用DNS主机名而不是IP地址。It is particularly important to use a DNS hostname instead of an IP address when configuring replica set members or sharded cluster members.在配置副本集成员或分片群集成员时,使用DNS主机名而不是IP地址尤为重要。
Use hostnames instead of IP addresses to configure clusters across a split network horizon. 使用主机名而不是IP地址来跨拆分的网络范围配置群集。Starting in MongDB 5.0, nodes that are only configured with an IP address will fail startup validation and will not start.从MongDB 5.0开始,仅配置IP地址的节点将无法启动验证,无法启动。
Use the 使用--bind_ip
option to ensure that MongoDB listens for connections from applications on configured addresses.--bind_ip
选项确保MongoDB侦听来自配置地址上的应用程序的连接。
Changed in version 3.6.在版本3.6中更改。
mongod
and mongos
, bind to localhost by default. mongod
和mongos
默认绑定到localhost。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
命令行选项,则该二进制文件还将绑定到本地主机ipv6地址。mongod
and mongos
that are bound to localhost only accept connections from clients that are running on the same computer. mongod
和mongos
只接受来自同一台计算机上运行的客户端的连接。mongosh
and other members of your replica set or sharded cluster. mongosh
和复制集或分片集群的其他成员。net.bindIp
configuration file setting or the --bind_ip
command-line option to specify a list of hostnames or IP addresses.net.bindIp
配置文件设置或--bind_IP
命令行选项指定主机名或IP地址列表。disableSplitHorizonIPCheck
.disableSplitHorizonIPCheck
。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
实例绑定到本地主机和主机名My-Example-Associated-Hostname
,该主机名与IP地址198.51.100.1关联:mongod --bind_ip localhost,My-Example-Associated-Hostname
198.51.100.1
:198.51.100.1
:mongosh --host My-Example-Associated-Hostname mongosh --host 198.51.100.1
Ensure that network traffic can pass securely between all members of the set and all clients in the network .确保网络流量可以在集合的所有成员和网络中的所有客户端之间安全传递。
Consider the following:考虑以下内容:
Ensure that each member of a replica set is accessible by way of resolvable DNS or hostnames. 确保可以通过可解析DNS或主机名访问副本集的每个成员。You should either configure your DNS names appropriately or set up your systems' 您应该适当配置DNS名称或设置系统的/etc/hosts
file to reflect this configuration./etc/hosts
文件以反映此配置。
Each member must be able to connect to every other member. 每个成员必须能够连接到其他每个成员。For instructions on how to check your connection, see Test Connections Between all Members.有关如何检查连接的说明,请参阅测试所有成员之间的连接。
Create the directory where MongoDB stores data files before deploying MongoDB.在部署MongoDB之前,创建MongoDB存储数据文件的目录。
Specify the 在mongod
configuration in a configuration file stored in /etc/mongod.conf
or a related location./etc/mongod.conf
或相关位置中存储的配置文件中指定mongod
配置。
For more information about configuration options, see Configuration File Options.有关配置选项的详细信息,请参阅配置文件选项。
The following procedure outlines the steps to deploy a replica set when access control is disabled.以下过程概述了在禁用访问控制时部署副本集的步骤。
For each member, start a 对于每个成员,使用以下设置启动mongod
instance with the following settings:mongod
实例:
replication.replSetName
option to the replica set name. replication.replSetName
选项设置为副本集名称。net.bindIp
option to the hostname/ip or a comma-delimited list of hostnames/ips.net.bindIp
选项设置为主机名/ip或以逗号分隔的主机名/ips列表。In this tutorial, the three 在本教程中,三个mongod
instances are associated with the following hosts:mongod
实例与以下主机关联:
Hostname | |
---|---|
Member 0 | mongodb0.example.net |
Member 1 | mongodb1.example.net |
Member 2 | mongodb2.example.net |
The following example specifies the replica set name and the ip binding through the 以下示例通过--replSet
and --bind_ip
command-line options:--replSet
和--bind_ip
命令行选项指定副本集名称和ip绑定:
Before binding to a non-localhost (e.g. publicly accessible) IP address, ensure you have secured your cluster from unauthorized access. 在绑定到非本地主机(例如,可公开访问的)IP地址之前,请确保已保护您的集群免受未经授权的访问。For a complete list of security recommendations, see Security Checklist. 有关安全建议的完整列表,请参阅安全检查表。At minimum, consider enabling authentication and hardening network infrastructure.至少要考虑启用身份验证和加强网络基础设施。
mongod --replSet "rs0" --bind_ip localhost,<hostname(s)|ip address(es)>
For 对于<hostname(s)|ip address(es)>
, specify the hostname(s) and/or ip address(es) for your mongod
instance that remote clients (including the other members of the replica set) can use to connect to the instance.<hostname(s)|ip address(es)>
,指定远程客户端(包括副本集的其他成员)可以用来连接到实例的mongod
实例的主机名和/或ip地址。
Alternatively, you can also specify the 或者,您也可以在配置文件中指定副本集名称和ip地址:replica set name
and the ip addresses
in a configuration file:
replication: replSetName: "rs0" net: bindIp: localhost,<hostname(s)|ip address(es)>
To start 要使用配置文件启动mongod
with a configuration file, specify the configuration file's path with the --config
option:mongod
,请使用--config
选项指定配置文件的路径:
mongod --config <path-to-config>
In production deployments, you can configure a init script to manage this process. 在生产部署中,您可以配置init脚本来管理此过程。Init scripts are beyond the scope of this document.初始化脚本超出了本文档的范围。
mongosh
to one of the mongod
instances.mongosh
连接到其中一个mongod
实例。From the same machine where one of the 从运行其中一个mongod
is running (in this tutorial, mongodb0.example.net
), start mongosh
. mongod
的同一台机器(在本教程中为mongodb0.example.net
),启动mongosh
。To connect to the 要在默认端口mongod
listening to localhost on the default port of 27017
, simply issue:27017
上连接到监听本地主机的mongod
,只需发出:
mongo
Depending on your path, you may need to specify the path to the 根据您的路径,您可能需要指定mongosh
binary.mongosh
二进制文件的路径。
From 从mongosh
, run rs.initiate()
on replica set member 0.mongosh
,对副本集成员0运行rs.initiate()
。
Run 仅在副本集的一个且仅一个rs.initiate()
on just one and only onemongod
instance for the replica set.mongod
实例上运行rs.initiate()
。
To avoid configuration updates due to IP address changes, use DNS hostnames instead of IP addresses. 为了避免由于IP地址更改而导致的配置更新,请使用DNS主机名而不是IP地址。It is particularly important to use a DNS hostname instead of an IP address when configuring replica set members or sharded cluster members.在配置副本集成员或分片群集成员时,使用DNS主机名而不是IP地址尤为重要。
Use hostnames instead of IP addresses to configure clusters across a split network horizon. 使用主机名而不是IP地址来跨拆分的网络范围配置群集。Starting in MongDB 5.0, nodes that are only configured with an IP address will fail startup validation and will not start.从MongDB 5.0开始,仅配置IP地址的节点将无法启动验证,无法启动。
rs.initiate( { _id : "rs0", members: [ { _id: 0, host: "mongodb0.example.net:27017" }, { _id: 1, host: "mongodb1.example.net:27017" }, { _id: 2, host: "mongodb2.example.net:27017" } ] })
MongoDB initiates a replica set, using the default replica set configuration.MongoDB使用默认副本集配置启动副本集。
Use 使用rs.conf()
to display the replica set configuration object:rs.conf()
显示副本集配置对象:
rs.conf()
The replica set configuration object resembles the following:副本集配置对象类似于以下内容:
{ "_id" : "rs0", "version" : 1, "protocolVersion" : NumberLong(1), "members" : [ { "_id" : 0, "host" : "mongodb0.example.net:27017", "arbiterOnly" : false, "buildIndexes" : true, "hidden" : false, "priority" : 1, "tags" : { }, "secondaryDelaySecs" : NumberLong(0), "votes" : 1 }, { "_id" : 1, "host" : "mongodb1.example.net:27017", "arbiterOnly" : false, "buildIndexes" : true, "hidden" : false, "priority" : 1, "tags" : { }, "secondaryDelaySecs" : NumberLong(0), "votes" : 1 }, { "_id" : 2, "host" : "mongodb2.example.net:27017", "arbiterOnly" : false, "buildIndexes" : true, "hidden" : false, "priority" : 1, "tags" : { }, "secondaryDelaySecs" : NumberLong(0), "votes" : 1 } ], "settings" : { "chainingAllowed" : true, "heartbeatIntervalMillis" : 2000, "heartbeatTimeoutSecs" : 10, "electionTimeoutMillis" : 10000, "catchUpTimeoutMillis" : -1, "getLastErrorModes" : { }, "getLastErrorDefaults" : { "w" : 1, "wtimeout" : 0 }, "replicaSetId" : ObjectId("585ab9df685f726db2c6a840") } }
Use 使用rs.status()
to identify the primary in the replica set.rs.status()
标识副本集中的主副本。