theforeman.foreman.foreman 回调 – 将事件发送到 Foreman

注意

此回调插件是 theforeman.foreman 集合 (版本 4.2.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install theforeman.foreman。您需要其他要求才能使用此回调插件，有关详细信息，请参阅要求。

要在剧本中使用它，请指定：theforeman.foreman.foreman。

回调插件 

此插件是一个**通知回调**。它将剧本运行的信息发送到其他应用程序、服务或系统。有关回调插件的更多信息，请参阅回调插件。

概要 

此回调将向 Foreman 报告事实和任务事件。

要求 

以下要求是在执行此回调的本地控制器节点上需要的。

配置中的白名单
requests（python 库）

参数 

参数	注释
client_cert 别名：ssl_cert 字符串	如果使用 https，则用于向 Foreman 进行身份验证的 X509 证书默认值： `"/etc/foreman/client_cert.pem"` 配置 INI 条目 [callback_foreman] ssl_cert = /etc/foreman/client_cert.pem [callback_foreman] client_cert = /etc/foreman/client_cert.pem 环境变量：`FOREMAN_SSL_CERT`
client_key 别名：ssl_key 字符串	相应的私钥默认值： `"/etc/foreman/client_key.pem"` 配置 INI 条目 [callback_foreman] ssl_key = /etc/foreman/client_key.pem [callback_foreman] client_key = /etc/foreman/client_key.pem 环境变量：`FOREMAN_SSL_KEY`
dir_store 字符串	设置后，回调不会执行 HTTP 调用，而是将结果存储在给定的目录中。对于每个报告，都会创建 SEQ_NO-hostname.json 形式的新文件。对于每个事实，都会创建 SEQ_NO-hostname.json 形式的新文件。该值必须是有效的目录。这用于调试和测试目的。设置为空白（默认值）时，此功能将关闭。默认值： `""` 配置 INI 条目 [callback_foreman] dir_store = "" 环境变量：`FOREMAN_DIR_STORE`
disable_callback 字符串	切换以使回调插件即使加载后也能自行禁用。可以将其设置为“1”以防止插件即使加载后也能使用。默认值： `0` 配置环境变量：`FOREMAN_CALLBACK_DISABLE`
proxy_url 字符串	Foreman Smart Proxy 服务器的 URL。配置 INI 条目 [callback_foreman] proxy_url = VALUE 环境变量：`FOREMAN_PROXY_URL`
report_type 字符串	报告的端点类型：foreman 或 proxy 默认值： `"foreman"` 配置 INI 条目 [callback_foreman] report_type = foreman 环境变量：`FOREMAN_REPORT_TYPE`
url 字符串 / 必需	Foreman 服务器的 URL。配置 INI 条目 [callback_foreman] url = VALUE 环境变量：`FOREMAN_URL` 环境变量：`FOREMAN_SERVER_URL` 环境变量：`FOREMAN_SERVER`
verify_certs 字符串	切换以决定是否验证 Foreman 证书。可以将其设置为“1”以使用已安装的 CA 验证 SSL 证书，或者设置为指向 CA 捆绑包的路径。设置为“0”以禁用证书检查。默认值： `1` 配置 INI 条目 [callback_foreman] verify_certs = 1 环境变量：`FOREMAN_SSL_VERIFY`

提示

每个条目类型的配置项具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖列表中较高的变量。