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

注意

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

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

要安装它，请使用：ansible-galaxy collection install theforeman.foreman。您需要进一步的要求才能使用此回调插件，请参阅要求了解详细信息。

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

回调插件 

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

概要 

此回调会将 facts 和任务事件报告给 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 格式的文件。对于每个 facts，都会创建一个新的 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`

提示

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