community.mongodb.mongodb_shutdown 模块 – 清理所有数据库资源，然后终止 mongod/mongos 进程。

注意

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

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

要安装它，请使用： ansible-galaxy collection install community.mongodb。您需要进一步的要求才能使用此模块，请参阅要求了解详细信息。

要在剧本中使用它，请指定：community.mongodb.mongodb_shutdown。

community.mongodb 1.0.0 中的新功能

概要 

清理所有数据库资源，然后终止进程。

要求 

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

pymongo

参数 

参数	注释
atlas_auth 布尔值	用于 MongoDB Atlas 实例的身份验证路径选择 `false` ← (默认) `true`
auth_mechanism 字符串	身份验证类型。选择 `"SCRAM-SHA-256"` `"SCRAM-SHA-1"` `"MONGODB-X509"` `"GSSAPI"` `"PLAIN"`
connection_options 列表 / 元素=任何	其他连接选项。以字典列表或包含用“=”分隔的键值对的字符串形式提供。
force 布尔值	指定 true 以强制 mongod 关闭。强制关闭会中断 mongod 上任何正在进行的操作，并可能导致意外行为。选择 `false` ← (默认) `true`
login_database 字符串	存储登录凭据的数据库。默认值: `"admin"`
login_host 字符串	运行要登录的 MongoDB 实例的主机。默认值: `"localhost"`
login_password 字符串	用于身份验证的密码。当指定 login_user 时，此项为必填项。
login_port 整数	要登录的 MongoDB 服务器端口。默认值: `27017`
login_user 字符串	用于登录的 MongoDB 用户。当指定 login_password 时，此项为必填项。
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` ← (默认)
timeout 整数	主节点应等待辅助节点赶上的秒数。默认值: `10`

说明 

注意

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

示例 

- name: Attempt to perform a clean shutdown
  community.mongodb.mongodb_shutdown:

- name: Force shutdown with a timeout of 60 seconds
  community.mongodb.mongodb_shutdown:
    force: true
    timeout: 60

返回值 

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

键	描述
changed 布尔值	成员是否已关闭。返回: 成功
failed 布尔值	如果出现问题返回: 失败
msg 字符串	对发生的事情的简短描述。返回: 成功

作者

Rhys Campbell (@rhysmeister)