对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

自动化配置参数

注意

注意：群组和项目是同义词。您的 {PROJECT-ID} 与您的项目 ID 相同。对于现有群组，群组/项目 ID 保持不变。当引用说明时，此页面将使用“群组”这个更为人熟知的术语。终结点仍如文档中所述。

本页介绍构成自动化配置的参数。

要查看其他示例，请参阅 mms-api-examples。

配置版本

这会列出自动化配置的版本。

"version" : "<integer>"
名称
类型
必要性
说明

版本

整型

必需

此自动化配置文件的修订版。

下载库

Ops Manager 下载自动版本并在options.downloadBase设置的目录中运行启动脚本。

"options" : {  "downloadBase" : "<string>",}
名称
类型
必要性
说明

选项

对象

必需

自动下载新版本的路径。

options.downloadBase

字符串

必需

Linux 和 UNIX 平台上用于自动版本下载和初创企业脚本的目录。

MongoDB 版本规范

mongoDbVersions[n]数组定义了在processes数组中找到的 MongoDB 实例的规范对象。 processes数组中的每个 MongoDB 实例都必须在该数组中具有规范对象。

"mongoDbVersions[n]" : [  {   "name" : "<string>",    "builds" : [      {       "platform" : "<string>",        "url" : "<string>",        "gitVersion" : "<string>",        "modules" : [ "<string>", ... ],        "architecture" : "<string>",        "bits" : "<integer>",        "win2008plus" : "<Boolean>",        "winVCRedistUrl" : "<string>",        "winVCRedistOptions" : [ "<string>", ... ],        "winVCRedistDll" : "<string>",        "winVCRedistVersion" : "<string>"      },      ...    ],  },  ...]
名称
类型
必要性
说明

mongoDbVersions[n]

对象数组

必需

在进程数组中找到的 MongoDB 实例的规范对象。 进程中的每个 MongoDB 实例都必须在mongoDbVersions[n]中具有规范对象。

mongoDbVersions[n].name

字符串

必需

规范对象的名称。 在此配置中，规范对象通过实例的processes.version参数附加到 MongoDB 实例。

mongoDbVersions[n].builds[k]

对象数组

必需

此 MongoDB 实例可用的版本。

mongoDbVersions[n].builds[k].platform

字符串

必需

此 MongoDB 实例的平台。

mongoDbVersions[n].builds[k].url

字符串

必需

为此实例下载 MongoDB 的URL 。

mongoDbVersions[n].builds[k].gitVersion

字符串

必需

提交标识符，用于标识用于构建 MongoDB 进程的代码的状态。MongoDB buildInfo 命令会返回 gitVersion 标识符。

mongoDbVersions[n].builds[k].modules

阵列

必需

此版本的模块列表。 对应于buildInfo命令返回的模块参数。

mongoDbVersions[n].builds[k].architecture

字符串

必需

处理器的架构。 Ops Manager 接受amd64或ppc64le 。

mongoDbVersions[n].builds[k].bits

整型

已弃用

处理器的总线宽度。 请勿删除或修改此参数。

mongoDbVersions[n].builds[k].win2008plus

布尔

Optional

如果这是需要 Windows 7 更高版本或 Windows 服务器 2008 R2 或更高版本的 Windows 版本，则设置为true 。

mongoDbVersions[n].builds[k].winVCRedistUrl

字符串

Optional

可从其中下载所需版本的 Microsoft Visual C++ 可再发行组件的URL 。

mongoDbVersions[n].builds[k].winVCRedistOptions

字符串数组

Optional

列出运行 Microsoft Visual C++ 可再发行组件安装程序时要指定的命令行选项的字符串值。 每个命令行选项都是数组中的一个单独字符串。

mongoDbVersions[n].builds[k].winVCRedistDll

字符串

Optional

Microsoft Visual C# 运行时 DLL 文件的名称，代理会检查该文件以确定是否需要新版本的 Microsoft Visual C# 可再发行组件。

mongoDbVersions[n].builds[k].winVCRedistVersion

字符串

Optional

要跳过 Microsoft Visual C++ 可再发行组件的安装，必须提供 Microsoft Visual C++ 运行时 DLL 的最低版本。

自动化

agentVersion指定 MongoDB Agent 的版本。

注意

为确保版本是最新的，请使用 更新代理版本 终结点，而不是通过此配置属性更新 MongoDB Agent 版本。

"agentVersion" : {  "name" : "<string>",  "directoryUrl" : "<string>"}
名称
类型
必要性
说明

AgentVersion

对象

Optional

要运行的 MongoDB Agent 的版本。如果运行版本与此设置不匹配，MongoDB Agent会下载指定版本，自行关闭，然后启动新版本。

AgentVersion.name

字符串

Optional

所需的 MongoDB Agent 版本。

AgentVersion.directoryUrl

字符串

Optional

用于下载 MongoDB Agent 的URL 。

MongoDB 进程

进程数组决定了 MongoDB 实例的配置。 使用此数组，您可以：

  • 恢复实例。

  • 在一个或多个 MongoDB 实例上启动初始同步进程。

"processes": [{  "<args>": {},  "alias": "<string>",  "authSchemaVersion": "<integer>",  "backupRestoreUrl": "<string>",  "certificatesVersion": "<integer>",  "cluster": "<string>",  "defaultRWConcern": {    "defaultReadConcern": {      "level": "<string>"    },    "defaultWriteConcern": {      "j": "<boolean>",      "w": "<string>",      "wtimeout": "<integer>"    }  }  "disabled": "<Boolean>",  "featureCompatibilityVersion": "<string>",  "hostname": "<string>",  "lastCompact" : "<dateInIso8601Format>",  "lastRestart" : "<dateInIso8601Format>",  "lastResync" : "<dateInIso8601Format>",  "lastKmipMasterKeyRotation" : "<dateInIso8601Format>",  "logRotate": {    "sizeThresholdMB": "<number>",    "timeThresholdHrs": "<integer>",    "numUncompressed": "<integer>",    "percentOfDiskspace": "<number>",    "numTotal": "<integer>"  },  "manualMode": "<Boolean>",  "name": "<string>",  "numCores": "<integer>",  "processType": "<string>",  "version": "<string>"}]
名称
类型
必要性
说明

processes

阵列

必需

包含定义 监控的mongos 和mongod MongoDB Ops Manager实例的对象。每个对象定义一个不同的实例。

processes[n].args2_6

对象

必需

MongoDB 2.6 及更高版本的 MongoDB 配置对象。

processes.args2_6对象接受 MongoDB 2.6 及更高版本的大多数 MongoDB 设置和参数。 要了解更多信息，请参阅MongoDB 设置和自动化支持。

processes[n].args2_6。 分片.clusterRole

字符串

可选的

此mongod进程在分片集群中的角色。

必需用于配置服务器和分片节点进程。如果您忽略此字段，部署可能会停滞在目标状态，因为 MongoDB 在没有对应启动标志的情况下无法启动。

接受的值：

  • configsvr — 用于配置服务器进程。

  • shardsvr — 用于分片节点进程。

processes[n].alias

字符串

Optional

运行进程的主机的主机名别名（通常是DNS CNAME）。 如果指定了别名，则在连接到主机时，MongoDB Agent会优先使用此别名，而不是在processes.hostname中指定的主机名。您还可以在replicaSets.host和sharding.configServer中指定此别名。

processes[n].authSchemaVersion

整型

必需

MongoDB 数据库用户的用户档案的模式版本。 这应该与进程数组中属于同一集群的所有其他元素匹配。

  • Ops Manager 接受此参数为3和5 。

  • MongoDB 3.x 和 4.x 集群默认为5 。

  • MongoDB 2.6 集群默认为3 .

要学习；了解更多信息，请参阅数据库手册中的SCRAM 。

processes[n].backupRestoreUrl

字符串

Optional

恢复的交付 URL。MongoDB Ops Manager 在创建恢复时设置此项。要取消正在进行的恢复操作，将此选项设置为 CANCEL。

要学习；了解更多信息，请参阅通过API自动执行备份恢复。

processes[n].certificatesVersion

整型

Optional

触发零停机时间 TLS 证书轮换的计数器。当您递增此值时，MongoDB Agent 会在每个符合条件的进程上运行 db.adminCommand({ rotateCertificates: 1 })，而不是重新启动它。应用仅适用于 mongod 和 mongos 运行 MongoDB 5.0 或更高版本的进程，并配置了 TLS。省略或设置为 null，以便将其视为 0。相等值不会 trigger 旋转。MongoDB Ops Manager 拒绝减量并报错 HTTP 400 INVALID_AUTOMATION_CONFIG。要了解更多，请参阅 在不停机的情况下轮换 TLS 证书。

processes[n].cluster

字符串

可选的

分片集群的名称。 将此值设置为与 的 mongos分片 数组中的 sharding.name 参数中的值相同的值。

defaultRWConcern.defaultReadConcern.level

字符串

Optional

为从副本集和副本集分片读取的数据设置的一致性和隔离性属性。 MongoDB Atlas 接受以下值：

  • "available"

  • "local"

  • “majority”

defaultRWConcern.defaultWriteConcern.j

布尔

Optional

指示写入确认是否必须写入磁盘日志的标志。

defaultRWConcern.defaultWriteConcern.w

字符串

Optional

必须确认副本集和副本集分片中的写入操作的 mongod 实例的所需数量。 MongoDB Atlas 接受以下值：

  • 0 或更大的任何数字

  • “majority”

defaultRWConcern.defaultWriteConcern.wtimeout

数字

Optional

写关注的所需时间限制（以毫秒为单位）。 将defaultRWConcern.defaultWriteConcern.w设置为大于1的值时，请设置此值。

processes[n].disabled

布尔

Optional

指示是否应关闭此进程的标志。 设置为true可关闭进程。

processes[n].featureCompatibilityVersion

字符串

必需

与此进程具有功能兼容性的 MongoDB 版本。 更改此值可以启用或禁用某些功能，这些功能会保留与早于或晚于您选择的featureCompatibilityVersion的 MongoDB 版本不兼容的数据。

  • Ops Manager 接受 5.0、6.0 和 7.0 作为参数值。如果您有现有部署，Ops Manager 只接受等于或比您部署的 MongoDB 版本旧一个版本的 featureCompatibilityVersion。要了解每个 MongoDB 版本支持哪些参数值，以及每个值启用或禁用哪些功能，请参阅 MongoDB 手册中的 setFeatureCompatibilityVersion。

  • Ops Manager 会设置此参数以匹配新部署的 MongoDB 版本。

  • 当您将主机从一个 MongoDB 版本升级到下一个时，Ops Manager 不会自动递增此参数。

要了解更多信息，请参阅 setFeatureCompatibilityVersion。

processes[n].hostname

字符串

必需

为该进程提供服务的主机名称。 默认为localhost 。

processes[n].lastCompact

字符串

Optional

Ops Manager上次回收集群磁盘上的可用空间时的 ISO 8601 日期和时间格式的时间戳（以 UTC 为单位）。在某些操作过程中， MongoDB可能会移动或删除数据，但不会释放当前未使用的空间。 Ops Manager以滚动方式跨副本集或分片的成员回收磁盘空间。

要回收此空间，请执行以下操作：

  • 立即将此值设立为当前时间，作为 ISO 8601 时间戳。

  • 稍后，将此值设立为未来的 ISO 8601 时间戳。MongoDB Ops Manager在当前时间超过提供的时间戳后回收空间。

要删除对何时回收集群磁盘上空间的任何歧义，请指定带有ISO 8601 时间戳的时区域。示例，要将 processes.lastCompact 设立为 28 2021 一月的 2:43:52 美国中部标准时间，请使用 "processes.lastCompact" : "2021-01-28T14:43:52-06:00"

processes[n].lastRestart

字符串

Optional

Ops Manager上次重新启动此进程时采用 ISO 8601 日期和时间格式（UTC 时间）的时间戳。如果将此参数设立为当前时间戳，Ops Manager会在您上传此配置后强制重新启动此进程。如果为同一集群中的多个进程设立此参数， Ops Manager将以滚动方式跨副本集或分片的成员重新启动所选进程。

processes[n].lastResync

字符串

Optional

Ops Manager在节点上执行的上次初始同步进程的 ISO8601 日期和时间格式（UTC 时间）的时间戳。

要立即触发节点上的初始化同步进程，请将此值设立为当前时间作为 ISO 8601 时间戳。

警告：请谨慎使用此参数。 在初始同步期间，自动化会删除节点dbPath目录的全部内容。

如果设置此参数：

  • 在从节点上，MongoDB Agent会检查指定的时间戳是否晚于上次重新同步的时间，如果确认，则在此节点上启动 init 同步。

    示例，要在从节点从节点(secondary node from replica set)processes.lastResync设立为28美国中部标准时间 5 月2021下午2 : 43 : 52 ，请使用：

    "processes.lastResync" : "2021-05-28T14:43:52-06:00"

    如果 MongoDB Agent 确认此时间戳晚于上次重新同步的记录时间，则会在该节点上启动 init 同步。

  • 在主节点上， MongoDB Agent会一直等到您使用rs.stepDown()方法要求主节点成为从节点，然后在此节点上启动 init 同步。

  • 在同一集群中的所有节点（包括主节点）上， MongoDB Agent会检查指定的时间戳是否晚于上次重新同步的时间，如果确认，则以滚动方式在从节点上启动 init 同步。 MongoDB Agent会一直等到您使用rs.stepDown()方法请求主节点成为从节点，然后在此节点上启动 init 同步。

要学习；了解更多信息，请参阅初始同步。

processes[n].lastKmipMasterKeyRotation

字符串

Optional

Ops Manager上次轮换主 KMIP 密钥时的 ISO 8601 日期和时间格式的时间戳（以 UTC 为单位）。如果将此参数设立为当前时间戳， Ops Manager将在您上传此配置后轮换密钥。

processes[n].logRotate

对象

Optional

用于轮换进程的 MongoDB 日志的 MongoDB 配置对象。

processes[n].logRotate。 numTotal

整型

Optional

Ops Manager 保留的日志文件总数。如果不设置此值，则日志文件总数默认为0 。 Ops Manager 根据其他进程进行轮换。logRotate 设置。

processes[n].logRotate。 numUncompressed

整型

Optional

保持未压缩状态的日志文件总数的最大数量，包括当前日志文件。 默认值为5 。

processes[n].logRotate。 PercentOfDiskspace

数字

Optional

Ops Manager 可用于存储日志文件的总磁盘空间的最大百分比，以十进制表示。如果超过此限制，Ops Manager 将删除压缩的日志文件，直到达到此限制。Ops Manager 首先删除最早的日志文件。

默认值为0.02 。

processes[n].logRotate。 sizeThresholdMB

数字

必需

Ops Manager 轮换日志文件之前，该文件的最大大小（以 MB 为单位）。如果日志文件达到sizeThresholdMB或processes.logRotate.timeThresholdHrs中给定的值，则 Ops Manager 会立即轮换日志文件限制。

processes[n].logRotate。 timeThresholdHrs

整型

必需

下次轮换之前单个日志文件的最大持续时间（以小时为单位）。 自上次轮换以来的时间。

一旦日志文件达到timeThresholdHrs或processes.logRotate.sizeThresholdMB ，Ops Manager 就会轮换日志文件限制。

processes[n].manualMode

布尔

Optional

指示 MongoDB Agent 是否自动执行此过程的标志。

  • 默认为false 。

  • 设置为true可暂停此进程的自动化。在恢复自动化之前， MongoDB Agent 不会对此进程采取进一步操作。

  • 设置为false可对此流程启用自动化。 MongoDB Agent会自动执行此进程中的操作。

processes[n].name

字符串

必需

用于标识实例的唯一名称。

processes[n].numCores

整型

Optional

Ops Manager 应绑定到此进程的核心数。MongoDB Agent 尽可能在各个核心之间均匀地分配进程。

processes[n].processType

字符串

必需

正在运行的 MongoDB 进程的类型。 MongoDB Ops Manager接受此参数的mongod或mongos 。

processes[n].version

字符串

必需

用于此实例的mongoDbVersions规范的名称。

集群范围

clusterWideConfigurations指定要在副本集或分片集群中设置的参数，而无需滚动重启。

"clusterWideConfigurations" : {  "<replicaSetID/clusterName>": {    "changeStreamOptions": {      "preAndPostImages": {        "expireAfterSeconds": <integer>      }    }  }}
名称
类型
必要性
说明

replicaSetID/clusterName

对象

Optional

要应用于副本集或分片集群的change stream选项。MongoDB Agent仅检查此配置是否采用有效的JSON格式，但不检查值的正确性。

changeStreamOptions.preAndPostImages.expireAfterSeconds

数字

必需

change stream前后映像的保留策略（以秒为单位）。如果省略该值，则集群将保留帖子和后映像，直到从 oplog 中删除相应的change stream事件。

如果删除此值，MongoDB Agent只会从其自动化配置中删除此参数，而不会从服务器中删除。

要了解更多信息，请参阅 changeStreamOptions。

副本集

replicaSets数组定义了每个副本集的配置。 对于具有副本集的部署，此字段为必填项。

"replicaSets":[  {    "_id": "<string>",    "protocolVersion": "<string>",    "members":    [      {        "_id": "<integer>",        "host": "<string>",        "arbiterOnly": "<boolean>",        "buildIndexes": "<boolean>",        "hidden": "<boolean>",        "priority": "<number>",        "tags": "<object>",        "secondaryDelaySecs": "<integer>",        "votes": "<number>"      },{        "_id": "<integer>",        "host": "<string>",        "arbiterOnly": "<boolean>",        "buildIndexes": "<boolean>",        "hidden": "<boolean>",        "priority": "<number>",        "tags": "<object>",        "secondaryDelaySecs": "<integer>",        "votes": "<number>"      },{        "_id": "<integer>",        "host": "<string>",        "arbiterOnly": "<boolean>",        "buildIndexes": "<boolean>",        "hidden": "<boolean>",        "priority": "<number>",        "tags": "<object>",        "secondaryDelaySecs": "<integer>",        "votes": "<number>"      }    ],    "force":    {      "currentVersion": "<integer>"    }  }]
名称
类型
必要性
说明

副本集

阵列

Optional

每个副本集的配置。 MongoDB Agent使用此数组中的值创建有效的副本集配置文档。 该代理会定期检查副本集是否配置正确。 如果出现问题，代理会根据其配置文档重新配置副本集。 该数组可以包含副本集配置文档中的以下顶级字段： _id ；版本；和成员。

要了解更多信息，请参阅 replSetGetConfig。

replicaSets[n]._id

字符串

必需

副本集的名称。

replicaSets[n].protocolVersion

字符串

Optional

副本集的协议版本。

replicaSets[n].members

阵列

Optional

定义副本集每个成员的对象。 members.host字段必须指定processes.name中列出的主机名称。 MongoDB Agent会扩展主机字段以创建有效的副本集配置。

要了解更多信息，请参阅 replSetGetConfig。

replicaSets[n].members[m]._id

整型

必需

指示副本集节点的任何正整数。

replicaSets[n].members[m].host

字符串

Optional

为该副本集成员提供服务的主机名和端口号（如适用）。

replicaSets[n].members[m].arbiterOnly

布尔

Optional

指示此副本集节点是否充当仲裁节点的标志。

replicaSets[n].members[m].buildIndexes

布尔

Optional

指示mongod进程是否在此副本集成员上构建索引的标志。

replicaSets[n].members[m].hidden

布尔

Optional

指示副本集是否允许该成员接受读操作的标志。

replicaSets[n].members[m].优先级

数字

Optional

Ops Manager 选择此副本集成员作为主成员的相对资格。 数量增加资格增加。 对于数据承载节点，该值可以介于 0 到 1000（含）之间。仲裁节点的值可以是 0 或 1。

replicaSets[n].members[m].tags

对象

Optional

应用于此副本集节点的用户定义标签及其值的列表。

replicaSets[n].members[m].secondaryDelaySecs

整型

Optional

此副本集节点应滞后于主节点的时间量（以秒为单位）。

replicaSets[n].members[m].votes

数字

Optional

该副本集成员可以为副本集选举投票的投票数量。 所有数据承载节点都可以有 0 或 1 票。 仲裁节点始终拥有 1 票投票权。

replicaSets[n].force

对象

Optional

MongoDB Agent指示 助手强制副本集使用在 replicaSets.force.CurrentVersion 中指定的 配置版本 的指令。

通过此对象，MongoDB Agent可以强制副本集接受新配置，以便从少数成员可用的状态中恢复。

replicaSets[n].force.currentVersion

整型

Optional

强制副本集使用的 配置版本 。MongoDB Agent设置为- 1可强制副本集接受新配置。

警告：强制重新配置副本集可能会导致多数提交写入操作回滚。 请谨慎操作。 如果您对此操作的潜在影响有任何疑问，请联系MongoDB支持部门。

分片集群

分片数组定义了每个分片集群的配置。 对于具有分片集群的部署，此参数是必需的。

"sharding" : [  {    "managedSharding" : false,    "name" : "<string>",    "configServerReplica" : "<string>",    "shards" : [      {        "_id" : "<string>",        "rs" : "<string>",        "tags" : [ "<string>", ... ]      },      ...    ],  },  ...]
名称
类型
必要性
说明

分片

对象数组

Optional

定义每个分片集群配置的对象。 数组中的每个对象都包含一个集群的规范。 MongoDB Agent会根据规范定期检查每个集群的状态。 如果规范和集群不匹配，代理将更改集群的配置，这可能会导致负载均衡器迁移数据段。

sharding.managedSharding

布尔

Optional

指示MongoDB Ops Manager自动化是否管理部署中的所有分片集合和标签的标志。 从MongoDB Ops Manager版本 7.0 开始，只能将其设置为 false。

sharding.name

字符串

可选的

集群名称。 它必须与 的 processes.cluster mongos中的值相对应。

sharding.configServerReplica

字符串

可选的

配置服务器副本集的名称。

如果您的配置服务器作为副本集运行，则可以添加此数组参数。

如果运行不作为副本集运行的旧版镜像配置服务器，请使用sharding.configServer 。

sharding.configServer

字符串数组

可选的

配置服务器主机的名称。 主机名称与每个主机的processes.name参数中使用的名称匹配。

重要提示： MongoDB 3.4已删除对镜像配置服务器的支持。 如果您的分片分片集群运行的是MongoDB 3.4或更高版本，请使用分片。

sharding.shards

对象数组

可选的

集群的分片。

sharding.shards._id

字符串

可选的

分片的名称。

sharding.shards.rs

字符串

可选的

分片副本集的名称。 这是在replicaSets._id 参数。

sharding.shards.tags

字符串数组

可选的

分配给此分片的区域。

如果使用分区分片，则可以添加此数组参数。

集群负载均衡器

负载均衡器对象是可选的，用于定义每个集群的负载均衡器设置。

"balancer": {  "<clusterName1>": {},  "<clusterName2>": {},  ...}
名称
类型
必要性
说明

平衡器

对象

Optional

以每个集群命名的参数，其中每个参数都包含一个具有该集群负载负载均衡器设置的对象。该对象使用“stopped”（停止）和“activeWindow”（活动窗口）参数。要了解更多信息，请参阅MongoDB 手册中的管理分片集群负载均衡器。

身份验证

要启用身份验证，请配置auth对象。 此对象是可选对象，用于定义与身份验证相关的设置。

{  "auth": {    "authoritativeSet": "<boolean>",    "autoUser": "<string>",    "autoPwd": "<string>",    "disabled": "<boolean>",    "deploymentAuthMechanisms": ["<string>", "<string>"],    "autoAuthMechanisms": ["<string>"],    "key": "<string>",    "keyfile": "<string>",    "newAutoPwd": "<string>",    "newKey": "<string>",    "usersDeleted": [{      "user": "<string>",      "dbs": ["<string>", "<string>"]    }],    "usersWanted": [{      "authenticationRestrictions": [{        "clientSource": ["(IP | CIDR range)", "(IP | CIDR range)"],        "serverAddress": ["(IP | CIDR range)", "(IP | CIDR range)"]      }],      "db": "<string>",      "initPwd": "<string>",      "otherDBRoles": {        "<string>": ["<string>", "<string>"]      },      "roles": [{        "db": "<string>",        "role": "<string>"      }],      "pwd": "<string>",      "user": "<string>"    }]  }}
名称
类型
必要性
说明

auth

对象

Optional

定义与身份验证相关的设置。

如果省略此参数，请跳过本节的其余部分。

auth.authoritativeSet

布尔

可选的

设置 MongoDB Ops Manager 是否在项目中的所有托管部署中实施一组一致的托管 MongoDB 用户和角色。

auth.authoritativeSet默认为false 。

如果启用身份验证，则为必填项。

auth.autoUser

字符串

可选的

自动化连接到实例时使用的用户名。

如果启用身份验证，则为必填项。

auth.autoPwd

字符串

可选的

自动化连接到实例时使用的密码。

如果启用身份验证，则为必填项。

auth.disabled

布尔

Optional

指示身份验证是否已禁用的标志。 如果未指定，则禁用默认为false 。

auth.deploymentAuthMechanisms

字符串数组

可选的

列出部署中的进程支持的身份验证机制。

如果启用身份验证，则为必填项。

指定：

auth.autoAuthMechanisms

字符串数组

可选的

设置自动化使用的身份验证机制。 如果未指定，则禁用默认为false 。

如果启用身份验证，则为必填项。

仅当为 SCRAM-SHA-1 和 SCRAM-SHA-256 配置时，此参数才包含多个元素。

指定：

auth.key

字符串

可选的

Ops Manager 用于对 MongoDB 进程进行身份验证的密钥文件的内容。

如果启用身份验证且"auth.disabled" : false ，则为必填项。

如果更改auth.key值，则必须更改auth.keyfile值。

auth.keyfile

字符串

可选的

Ops Manager 用于对 MongoDB 进程进行身份验证的密钥文件的路径和名称。

如果启用身份验证且"auth.disabled" : false ，则为必填项。

如果更改auth.keyfile值，则必须更改auth.key值。

auth
.newAutoPwd

字符串

Optional

自动化连接到实例时使用的新密码。 要在不中断连接的情况下轮换密码，请执行以下操作：

  1. 设置auth.newAutoPwd并让auth.autoPwd保留当前密码。

  2. 等待目标状态。

  3. auth.newAutoPwd会自动复制auth.autoPwd密码。

仅当您将 SCRAM-SHA-1 或 SCRAM-SHA-256 作为auth.autoAuthMechanisms中自动化的身份验证机制之一时，才能设置此选项。

auth.newKey

字符串

Optional

您希望 Ops Manager 使用该文件对 MongoDB 进程进行身份验证的新文件的内容。

设置此选项时，Ops Manager 会轮换应用程序用于对部署中的 MongoDB 进程进行身份验证的密钥。当所有 MongoDB 代理都使用新密钥时，Ops Manager 会将auth.key的值替换为您在auth.newKey中提供的新密钥，并从自动化配置中删除auth.newKey 。

auth.usersDeleted

对象数组

Optional

定义要从指定数据库或所有数据库中删除的经过身份验证的用户的对象。 此数组必须包含auth.usersDeleted.user和auth.usersDeleted.dbs 。

auth.usersDeleted[n].user

字符串

Optional

Ops Manager 应删除的用户名。

auth.usersDeleted[n].dbs

字符串数组

Optional

列出 Ops Manager 应从中删除经过身份验证的用户的数据库的名称。

auth.usersWanted

对象数组

Optional

包含对象，这些对象定义要添加到指定数据库的经过身份验证的用户。 每个对象都必须具有auth.usersWanted[n].db 、 auth.usersWanted[n].user 、 和auth.usersWanted[n].角色 参数，然后恰好具有以下参数之一： auth.usersWanted[n].pwd ， auth.usersWanted[n].initPwd 、 或auth.usersWanted[n].userSource 。

auth.usersWanted[n].db

字符串

可选的

要添加用户的数据库。

auth.usersWanted[n].user

字符串

可选的

Ops Manager 应添加的用户名称。

auth.usersWanted[n].角色

阵列

可选的

要从用户数据库分配给用户的角色列表，在auth.usersWanted[n].db中指定。

auth.usersWanted[n].pwd

字符串

可选的

当前分配给用户的密码的 32 字符十六进制SCRAM-SHA-1哈希值。

Ops Manager 不会使用此参数来设置或更改密码。

在以下情况下为必填项：

  • 您启用身份验证

  • "auth.deploymentAuthMechanisms" : "MONGODB-CR"

  • 未设置“auth.usersWanted[n].initPwd”

auth.usersWanted[n].initPwd

字符串

可选的

要分配给用户的明文密码。

在以下情况下为必填项：

  • 您启用身份验证

  • "auth.deploymentAuthMechanisms" : "MONGODB-CR"

  • 未设置“auth.usersWanted[n].initPwd”

auth.usersWanted[n].userSource

字符串

已弃用

不再支持。

auth.usersWanted[n].otherDBRoles

对象

Optional

如果分配用户的数据库"auth.usersWanted[n].db" : "admin" ，那么您也可以使用此对象分配其他数据库中的用户角色。 该对象包含键值对，其中键是数据库的名称，值是列出从该数据库分配的角色的字符串值数组。

auth.usersWanted[n].authenticationRestrictions

文档数组

Optional

主机对用户实施的身份验证限制。

警告：如果用户继承的多个角色具有不兼容的身份验证限制，则该用户将无法使用。 示例，如果用户继承了一个角色（其中clientSource字段为[198.51.100.0]和另一个角色（其中clientSource字段为[203.0.113.0] ，则服务器无法对该用户进行身份验证。 有关MongoDB中身份身份验证的更多信息，请参阅身份验证。

auth.usersWanted[n].authenticationRestrictions[k].clientSource

字符串数组

可选的

如果在对用户进行身份验证时存在，则主机将验证给定列表是否包含客户端的 IP 地址CIDR范围。 如果客户端的 IP 地址不存在，则主机不会对用户进行身份验证。

auth.usersWanted[n].authenticationRestrictions[k].serverAddress

字符串数组

可选的

客户端可以连接的以逗号分隔的 IP 地址数组。 如果存在，则主机验证 Ops Manager 是否接受了来自给定数组中 IP 地址的客户端连接。 如果从无法识别的 IP 地址接受连接，则主机不会对用户进行身份验证。

LDAP

ldap 对象可以启用 LDAP 授权。此对象是可选的。要学习；了解更多信息，请参阅管理Ops Manager项目的LDAP身份验证。

 "ldap": {   "servers": "<host>:<port>, <host>:<port>",   "timeoutMS": "<time>",   "bindMethod": "<sasl/simple>",   "bindSaslMechanisms": "<sasl-mechanism>, <sasl-mechanism>",   "bindQueryUser": <ldap-dn>",   "bindQueryPassword": "<password>",   "userCacheInvalidationPeriod": "<interval>",   "authzQueryTemplate": "<rfc-4516-url>",   "userToDNMapping": [             {                     "match": "<ECMAScript-regex>",                     "<substition/ldapQuery>": "<DN-string/RFC4516-encoded-LDAP-query>"             }   ]}
名称
类型
必要性
说明

ldap

对象

Optional

包含用于启用和配置LDAP授权的设置的对象。

ldap.servers

字符串

可选的

逗号分隔的 string，其中包含一个或多个 LDAP 服务器，采用 <host>:<port> 格式以执行查询。您可以使用 setParameter 在运行中的系统上配置此设置。对于 LDAP 授权，您必须指定此设置。

ldap.timeoutMS

long

Optional

MongoDB 在超时前等待 LDAP 服务器响应请求的时间量（以毫秒为单位）。您可以使用 setParameter 来在运行系统上配置此设置。默认情况下，MongoDB 在十秒后超时。

ldap.bindMethod

字符串

Optional

人可读的 string，指示是否使用简单身份验证或 SASL 协议进行身份验证。您可以指定 simple 或 sasl。默认情况下，MongoDB 使用简单身份验证。

ldap.bindSaslMechanisms

字符串

Optional

包含以逗号分隔的 SASL 机制列表的 string，供 MongoDB 在绑定时尝试对 LDAP 服务器进行身份验证。默认情况下，MongoDB 使用 DIGEST-MD5 进行绑定。

ldap.bindQueryUser

字符串

可选的

LDAP 实体域名称：当 MongoDB 连接到 LDAP 服务器时绑定使用的名称。您可以使用 setParameter 在运行中的系统上配置此设置。要使 MongoDB 与身份验证凭证绑定，必须指定此设置。

ldap.bindQueryPassword

字符串

可选的

MongoDB 连接到 LDAP 服务器时用于绑定的密码。您可以使用 setParameter 来在运行系统上配置此设置。要使 MongoDB 使用密码进行认证，您必须指定此设置。

ldap.userCacheInvalidationPeriod

整型

Optional

MongoDB 在用户缓存刷新之间等待的间隔。当外部用户缓存被清空时，经 LDAP 授权用户的下一个操作需要重新获取角色。如果指定一个较高的值，可能会减少 LDAP 服务器的负载，并增加将 MongoDB 角色与 LDAP 组成员身份同步所需的时间。默认情况下，MongoDB 在两次缓存冲刷之间等待 30 秒。

ldap.authzQueryTemplate

字符串

可选的

RFC 4516 格式的LDAP查询URL ，要执行该查询以获得与 ldap.server 设置相关的LDAP群组。在此URL中，占位符令牌字符串 {USER} 将替换为获取的用户域名。您可以使用 setParameter 在运行的系统上配置此设置。对于LDAP授权，您必须指定此设置。

ldap.userToDNMapping

阵列

Optional

JSON格式的数组，包含 MongoDB 应用的有序变换，用于验证 MongoDB 用户名以匹配其域名。如果您使用其他身份验证方法，或者，传递给 MongoDB 进行身份验证的用户名与 LDAP 域名不匹配，则可以指定此设置。您可以使用 setParameter 在运行中的系统上配置此设置。默认情况下，MongoDB 使用用户名作为域名，用于自动 LDAP 授权。

TLS

可选的 tls对象启用 TLS 来加密连接。

"tls" : {  "CAFilePath" : "<string>"}
名称
类型
必要性
说明

TLS

对象

Optional

启用TLS以加密连接。 要使用TLS ，请选择支持TLS的包。

所有支持MongoDB Enterprise的平台也都支持TLS 。

tls.CAFilePath

字符串

可选的

用于通过TLS进行身份验证的证书的绝对文件路径。 如果设置了 tls.clientCertificateMode ，则为必填项。

tls.clientCertificateMode

字符串

可选的

指定与Ops Manager 的连接是否需要TLS证书。Ops Manager接受 可选 和 REQUIRE。如果设立了tls.CAFilePath，则为必填项。

MongoDB 角色

roles数组是可选的，用于描述用户定义的角色。

"roles" : [  {    "role" : "<string>",    "db" : "<string>",    "privileges" : [      {        "resource" : { ... },        "actions" : [ "<string>", ... ]      },      ...    ],    "roles" : [      {        "role" : "<string>",        "db" : "<string>"      }    ]    "authenticationRestrictions" : [     {      "clientSource": [("<IP>" | "<CIDR range>"), ...],      "serverAddress": [("<IP>" | "<CIDR range>"), ...]    }, ...  ]  },  ...]
名称
类型
必要性
说明

角色

对象数组

Optional

MongoDB 分配给集群的用户定义角色的角色和权限。 每个对象描述一个不同的用户定义角色。 此数组中的对象包含与系统角色集合中的文档相同的字段，但_id字段除外。

roles[n].role

字符串

可选的

用户定义角色的名称。

roles[n].db

字符串

可选的

自定义角色所属的数据库。

roles[n].privileges

文档数组

可选的

此角色可以执行的特权。

roles[n].privileges[k].resource

字符串

可选的

指定权限操作适用的资源。

roles[n].privileges[k].actions

字符串

可选的

允许对资源执行的操作。

要学习；了解更多信息，请参阅特权操作。

roles[n].roles

文档数组

可选的

此角色从中继承权限的角色。

角色[n].authenticationRestrictions

文档数组

Optional

MongoDB Server 对此角色实施的身份验证限制。

警告：如果用户继承的多个角色具有不兼容的身份验证限制，则该用户将无法使用。 示例，如果用户继承了一个角色（其中clientSource字段为[198.51.100.0]和另一个角色（其中clientSource字段为[203.0.113.0] ，则服务器无法对该用户进行身份验证。 有关MongoDB中身份身份验证的更多信息，请参阅身份验证。

角色[n].authenticationRestrictions[k].clientSource

字符串数组

可选的

如果存在，则在对用户进行身份验证时，MongoDB 服务器会验证客户端的 IP 地址是否在给定列表中或属于列表中的CIDR范围。 如果客户端的 IP 地址不存在，则 MongoDB Server 不会对用户进行身份验证。

角色[n].authenticationRestrictions[k].serverAddress

字符串数组

可选的

客户端可以连接的以逗号分隔的 IP 地址数组。 如果存在，MongoDB Server会验证它是否接受了来自给定数组中 IP 地址的客户端连接。如果 MongoDB Server 接受来自无法识别的 IP 地址的连接，则 MongoDB Server 不会对用户进行身份验证。

Kerberos

kerberos对象是可选的，它定义身份验证中使用的Kerberos服务名称。

"kerberos": {  "serviceName": "<string>"}
名称
类型
必要性
说明

kerberos

对象

Optional

定义Kerberos服务名称代理用于通过Kerberos进行身份验证的键值对。

kerberos.serviceName

字符串

必需

设置以下内容的标签：

索引

indexConfigs数组是可选的，用于定义要为特定副本集构建的索引。

"indexConfigs": [{  "key": [    ["<string>", "<value>"]  ],  "rsName": "<string>",  "dbName": "<string>",  "collectionName": "<string>",  "collation": {    "locale": "<string>",    "caseLevel": <boolean>,    "caseFirst": "<string>",    "strength": <number>,    "numericOrdering": <boolean>,    "alternate": "<string>",    "maxVariable": "<string>",    "normalization": <boolean>,    "backwards": <boolean>  },  "options": {    "<key>": "<value>"  }}]
名称
类型
必要性
说明

indexConfigs

对象数组

Optional

为特定副本集构建的特定索引。

indexConfigs.key

数组的数组

必需

索引中的键。 如果索引只有一个键，则此“数组的数组”包含单个数组。

indexConfigs.rsName

字符串

必需

MongoDB 在其上构建索引的副本集。

indexConfigs.dbName

字符串

必需

MongoDB 建立索引的数据库。

indexConfigs.collectionName

字符串

必需

MongoDB 索引的collection。

indexConfigs.collation

对象

Optional

如果索引使用排序规则，则在对字符串进行排序和匹配时要使用的特定于语言的规则。

如果包含indexConfigs.collation对象，则必须包含indexConfigs.collation.locale参数。 所有其他参数都是可选的。

如果不包含indexConfigs.collation对象，则索引无法包含排序规则。

indexConfigs.collation.locale

字符串

必需

ICU 定义的区域设置。

MongoDB Server 手册在其排序规则区域设置和默认参数部分列出了支持的区域设置。

要指定简单二进制比较，请将此值设置为simple 。

indexConfigs.collation.caseLevel

布尔

Optional

指示索引如何使用案例的标志。

如果将此参数设置为true ，则索引将使用大小写比较。

仅当将indexConfigs.collation.strength设置为1或2时，此参数才会应用。

要学习；了解详情，请参阅排序规则。

indexConfigs.collation.caseFirst

字符串

Optional

三级比较期间大小写差异的排序顺序。

MongoDB Server手册在其排序规则部分列出了可能的值。

indexConfigs.collation.strength

数字

Optional

要执行的比较级别。对应于ICU 比较级别。

MongoDB Server手册在其排序规则部分列出了可能的值。

indexConfigs.collation.numericOrdering

布尔

Optional

指示如何比较数字字符串的标志。

  • true: 数字字符串作为数字进行比较。示例，10 > 2。

  • false: 数字字符串作为字符串进行比较。示例，10 < 2。

默认为false 。

要学习；了解详情，请参阅排序规则。

indexConfigs.collation.alternate

字符串

Optional

用于确定排序规则在比较期间如何将空格和标点符号视为基本字符的设置。

MongoDB Server手册在其排序规则部分列出了可能的值。

indexConfigs.collation.maxVariable

字符串

Optional

索引可以忽略的字符。 此参数仅在将indexConfigs.collation.alternate设置为shifted时适用。

MongoDB Server手册在其排序规则部分列出了可能的值。

indexConfigs.collation.normalization

布尔

Optional

指示是否将文本正常化的标志。

如果将此参数设置为true ，则排序规则：

  • 检查文本是否需要规范化。

  • 执行规范化以比较文本。

默认为false 。

要学习；了解详情，请参阅排序规则。

indexConfigs.collation.backwards

布尔

Optional

指示索引应如何处理变音符号字符串的标志。

如果将此参数设置为true ，则带有变音符号的字符串从后到前排序。

默认为false 。

要学习；了解详情，请参阅排序规则。

indexConfigs.options

文档

必需

MongoDB Go 驱动程序支持的索引选项。

后退
更新自动化配置（无密钥）
来年
自动化配置示例
给本页内容打分

在此页面上