使用密钥文件身份验证部署自管理的分片集群

启动配置服务器副本集中的 每个 mongod。包括 keyFile 设置。该 keyFile 设置强制执行 自我管理内部/成员身份验证 以及 自我管理部署中的基于角色的访问控制。

您可以通过配置文件或命令行指定 mongod 设置。

配置文件

如果使用配置文件，将 security.keyFile 设置为密钥文件的路径，将 sharding.clusterRole 设置为 configsvr，将 replication.replSetName 设置为配置服务器副本集的所需名称。

security:
  keyFile: <path-to-keyfile>
sharding:
  clusterRole: configsvr
replication:
  replSetName: <setname>

根据您的配置需求包括其他选项。例如，如果您希望远程客户端连接到您的部署或您的部署成员运行在不同的主机上，请指定 net.bindIp 设置。

使用 --config 选项和配置文件的路径启动 mongod。

mongod --config <path-to-config-file>

命令行

如果使用命令行参数，请使用mongod启动程序，并带上--keyFile、--configsvr和--replSet参数。

mongod --keyFile <path-to-keyfile> --configsvr --replSet <setname> --dbpath <path>

根据您的配置需要包含额外的选项。例如，如果您希望远程客户端连接到您的部署，或者您的部署成员在不同的主机上运行，请指定--bind_ip。

通过localhost接口连接到副本集的成员。

通过localhost接口连接到mongod实例的mongosh。您必须在与mongod实例相同的物理机上运行mongosh。

localhost接口仅在尚未为部署创建用户时可用。创建第一个用户后，localhost接口会关闭。

rs.initiate()方法启动副本集，并可以接受一个可选的副本集配置文档。在副本集配置文档中包含：

• _id。该_id必须与传递给mongod的--replSet参数匹配。

• members 字段。该 members 字段是一个数组，并为副本集的每个成员需要指定一个文档。

• configsvr 字段。对于配置服务器副本集，必须将 configsvr 字段设置为 true。

有关副本集配置文档的更多信息，请参阅自管理副本集配置。

使用 rs.initiate() 方法和一个配置文档来初始化副本集。

rs.initiate(
  {
    _id: "myReplSet",
    configsvr: true,
    members: [
      { _id : 0, host : "cfg1.example.net:27019" },
      { _id : 1, host : "cfg2.example.net:27019" },
      { _id : 2, host : "cfg3.example.net:27019" }
    ]
  }
)

以启用访问控制的模式启动副本集的每个成员。

使用带有 keyFile 参数的 mongod 运行强制执行自管理内部/成员身份验证和自管理部署中的基于角色的访问控制。

使用配置文件或命令行在副本集中启动每个 mongod。

配置文件

如果使用配置文件，将 security.keyFile 选项设置为密钥文件的路径，将 replication.replSetName 设置为副本集的期望名称，将 sharding.clusterRole 选项设置为 shardsvr。

security:
  keyFile: <path-to-keyfile>
sharding:
  clusterRole: shardsvr
replication:
  replSetName: <replSetName>
storage:
   dbPath: <path>

根据您的配置需求包括其他选项。例如，如果您希望远程客户端连接到您的部署或您的部署成员运行在不同的主机上，请指定 net.bindIp 设置。

使用 --config 选项和配置文件的路径启动 mongod。

mongod --config <path-to-config-file>

命令行

如果使用命令行选项，在启动组件时指定 --keyFile、replSet 和 --shardsvr 参数，例如以下示例

mongod --keyFile <path-to-keyfile> --shardsvr --replSet <replSetName>  --dbpath <path>

根据您的配置需要包含额外的选项。例如，如果您希望远程客户端连接到您的部署，或者您的部署成员在不同的主机上运行，请指定--bind_ip。

通过 localhost 接口连接到副本集的成员。

通过localhost接口连接到mongod实例的mongosh。您必须在与mongod实例相同的物理机上运行mongosh。

localhost接口仅在尚未为部署创建用户时可用。创建第一个用户后，localhost接口会关闭。

初始化副本集。

从 mongosh，运行 rs.initiate() 方法。

rs.initiate() 可以接受一个可选的 replica set configuration document。在 replica set configuration document 中包含

• 将 _id 字段设置为在 replication.replSetName 或 --replSet 选项中指定的副本集名称。

• 包含每个副本集成员的文档的 members 数组。

以下示例启动一个包含三个成员的副本集。

rs.initiate(
  {
    _id : "myReplSet",
    members: [
      { _id : 0, host : "s1-mongo1.example.net:27018" },
      { _id : 1, host : "s1-mongo2.example.net:27018" },
      { _id : 2, host : "s1-mongo3.example.net:27018" }
    ]
  }
)

rs.initiate() 触发选举并从成员中选出一个是 主节点。

在继续之前连接到主节点。使用 rs.status() 定位主节点成员。

创建分片本地用户管理员（可选）。

使用 db.createUser() 方法添加用户。用户应在 admin 数据库上至少具有 userAdminAnyDatabase 角色。

您必须连接到 主节点 才能创建用户。

以下示例在 admin 数据库上创建名为 fred 的用户，并赋予其 userAdminAnyDatabase 角色。

admin = db.getSiblingDB("admin")
admin.createUser(
  {
    user: "fred",
    pwd: passwordPrompt(), // or cleartext password
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
  }
)

在提示时输入密码。有关数据库管理操作相关内置角色的完整列表，请参阅 数据库用户角色。

作为分片本地用户管理员进行身份验证（可选）。

对 admin 数据库进行身份验证。

在 mongosh 中，使用 db.auth() 进行身份验证。例如，以下为用户管理员 fred 进行身份验证。

db.getSiblingDB("admin").auth("fred", passwordPrompt()) // or cleartext password

或者，使用 -u <username>、-p <password> 和 --authenticationDatabase 参数将新的 mongosh 实例连接到主副本集成员。

mongosh -u "fred" -p  --authenticationDatabase "admin"

如果您未指定命令行选项 -p 的密码，mongosh 将提示输入密码。

创建分片本地集群管理员（可选）。

分片本地集群管理员用户具有 clusterAdmin 角色，该角色提供允许访问复制操作的权限。

有关与副本集操作相关的角色完整列表，请参阅集群管理角色。

创建一个集群管理员用户，并在admin数据库中分配clusterAdmin角色。

db.getSiblingDB("admin").createUser(
  {
    "user" : "ravi",
    "pwd" : passwordPrompt(),     // or cleartext password
    roles: [ { "role" : "clusterAdmin", "db" : "admin" } ]
  }
)

根据提示输入密码。

有关与副本集和分片集群操作相关的内置角色完整列表，请参阅集群管理角色。

将mongos连接到集群

使用配置文件或命令行参数指定密钥文件来启动mongos。

配置文件

如果使用配置文件，设置security.keyFile为密钥文件的路径，并将sharding.configDB设置为副本集名称以及至少一个副本集成员的<replSetName>/<host:port>格式。

security:
  keyFile: <path-to-keyfile>
sharding:
  configDB: <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019,...

根据您的配置需求包括其他选项。例如，如果您希望远程客户端连接到您的部署或您的部署成员运行在不同的主机上，请指定 net.bindIp 设置。

指定--config选项和配置文件路径来启动mongos。

mongos --config <path-to-config>

命令行

如果使用命令行参数，则指定--keyFile和--configdb参数来启动mongos。

mongos --keyFile <path-to-keyfile> --configdb <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019,...

根据您的配置需要包含额外的选项。例如，如果您希望远程客户端连接到您的部署，或者您的部署成员在不同的主机上运行，请指定--bind_ip。

通过本地接口连接到 mongos。

通过本地接口将 mongosh 连接到 mongos 实例之一。您必须在与 mongos 实例相同的物理机器上运行 mongosh。

localhost接口仅在尚未为部署创建用户时可用。创建第一个用户后，localhost接口会关闭。

创建用户管理员。

使用 db.createUser() 方法添加用户。用户应在 admin 数据库上至少具有 userAdminAnyDatabase 角色。

以下示例在 admin 数据库中创建了用户 fred。

admin = db.getSiblingDB("admin")
admin.createUser(
  {
    user: "fred",
    pwd:  passwordPrompt(),     // or cleartext password
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
  }
)

有关内置角色及其与数据库管理操作的相关信息，请参阅数据库用户角色。

以用户管理员身份进行认证。

使用 db.auth() 以用户管理员身份进行认证以创建更多用户

db.getSiblingDB("admin").auth("fred", passwordPrompt()) // or cleartext password

根据提示输入密码。

或者，使用 -u <username>、-p <password> 和 --authenticationDatabase "admin" 参数连接到目标副本集成员的新 mongosh 会话。您必须使用 自托管部署中的本地主机异常 来连接到 mongos。

mongosh -u "fred" -p  --authenticationDatabase "admin"

如果您未指定命令行选项 -p 的密码，mongosh 将提示输入密码。

创建集群管理的管理员用户

集群管理员用户具有 clusterAdmin 角色，该角色授予对复制和分片操作的访问权限。

在 admin 数据库中创建一个 clusterAdmin 用户。

以下示例在 admin 数据库中创建了用户 ravi。

db.getSiblingDB("admin").createUser(
  {
    "user" : "ravi",
    "pwd" : passwordPrompt(),     // or cleartext password
    roles: [ { "role" : "clusterAdmin", "db" : "admin" } ]
  }
)

有关与副本集和分片集群操作相关的内置角色完整列表，请参阅集群管理角色。

创建更多用户（可选）。

创建用户以允许客户端连接并访问分片集群。有关可用的内置角色，例如 数据库用户角色，例如 read 和 readWrite，请参阅。您可能还需要额外的管理员用户。有关用户的信息，请参阅 自管理部署中的用户。

要创建额外的用户，您必须以具有 userAdminAnyDatabase 或 userAdmin 角色的用户身份进行身份验证。