community.mongodb.mongodb_oplog 模块 – 调整 MongoDB oplog 大小。

注意

此模块是 community.mongodb 集合 (版本 1.7.8) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.mongodb。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：community.mongodb.mongodb_oplog。

community.mongodb 1.0.0 中的新增功能

概要 

调整 MongoDB oplog 大小。
此模块仅应与 MongoDB 3.6 及更高版本一起使用。
旧版 MongoDB 应使用替代方法。
有关更多信息，请参阅 https://docs.mongodb.com/manual/tutorial/change-oplog-size。

要求 

执行此模块的主机需要以下要求。

pymongo

参数 

参数	注释
atlas_auth 布尔值	适用于 MongoDB Atlas 实例的身份验证路径选项 `false` ← (默认) `true`
auth_mechanism 字符串	身份验证类型。选项 `"SCRAM-SHA-256"` `"SCRAM-SHA-1"` `"MONGODB-X509"` `"GSSAPI"` `"PLAIN"`
compact 布尔值	对 local 数据库中的 oplog.rs 集合运行 compact 操作以回收磁盘空间。不对 PRIMARY 成员执行任何操作。 MongoDB 用户必须在 local 数据库中具有 compact 角色才能使用此功能。选项 `false` ← (默认) `true`
connection_options 列表 / 元素=任意	其他连接选项。作为字典或字符串列表提供，键值对用 ‘=’ 分隔。
login_database 字符串	存储登录凭据的数据库。默认值： `"admin"`
login_host 字符串	运行要登录的 MongoDB 实例的主机。默认值： `"localhost"`
login_password 字符串	用于身份验证的密码。当指定 login_user 时必需。
login_port 整数	要登录的 MongoDB 服务器端口。默认值： `27017`
login_user 字符串	要登录的 MongoDB 用户。当指定 login_password 时必需。
oplog_size_mb 整数 / 必需	oplog 的新大小（以 MB 为单位）。
ssl 别名：tls 布尔值	连接到数据库时是否使用 SSL 连接。选项 `false` ← (默认) `true`
ssl_ca_certs 别名：tlsCAFile 字符串	ssl_ca_certs 选项接受 CA 文件的路径。
ssl_cert_reqs 别名：tlsAllowInvalidCertificates 字符串	指定是否需要连接另一端提供证书，以及如果提供是否会验证证书。选项 `"CERT_NONE"` `"CERT_OPTIONAL"` `"CERT_REQUIRED"` ← (默认)
ssl_certfile 别名：tlsCertificateKeyFile 字符串	使用 ssl_certfile 选项提供客户端证书。
ssl_crlfile 字符串	ssl_crlfile 选项接受 CRL 文件的路径。
ssl_keyfile 字符串	客户端证书的私钥。
ssl_pem_passphrase 别名：tlsCertificateKeyFilePassword 字符串	解密加密私钥的密码。
strict_compatibility 布尔值	对 pymongo 和 MongoDB 软件版本强制执行严格的要求选项 `false` `true` ← (默认)

注释 

注意

需要远程主机上的 pymongo Python 包，版本 4+。可以使用 pip 或操作系统包管理器安装。@see http://api.mongodb.org/python/current/installation.html

示例 

- name: Resize oplog to 16 gigabytes, or 16000 megabytes
  community.mongodb.mongodb_oplog:
    oplog_size_mb: 16000

- name: Resize oplog to 8 gigabytes and compact secondaries to reclaim space
  community.mongodb.mongodb_oplog:
    oplog_size_mb: 8000
    compact: true

返回值 

此处记录了常见的返回值此处，以下是此模块独有的字段

键	描述
changed 布尔值	成员 oplog 是否已修改。返回值：success
compacted 布尔值	成员 oplog 是否已压缩。返回值：success
failed 布尔值	如果出现问题返回值：failed
msg 字符串	简短描述发生了什么。返回值：success

作者

Rhys Campbell (@rhysmeister)