theforeman.foreman.foreman – Sends events to Foreman

Note

This plugin is part of the theforeman.foreman collection (version 2.1.1).

To install it use: ansible-galaxy collection install theforeman.foreman.

To use it in a playbook, specify: theforeman.foreman.foreman.

Synopsis

  • This callback will report facts and task events to Foreman

Requirements

The below requirements are needed on the local controller node that executes this callback.

  • whitelisting in configuration

  • requests (python library)

Parameters

Parameter Choices/Defaults Configuration Comments
client_cert
string
Default:
"/etc/foreman/client_cert.pem"
ini entries:

[callback_foreman]
ssl_cert = /etc/foreman/client_cert.pem

[callback_foreman]
client_cert = /etc/foreman/client_cert.pem

env:FOREMAN_SSL_CERT
X509 certificate to authenticate to Foreman if https is used

aliases: ssl_cert
client_key
string
Default:
"/etc/foreman/client_key.pem"
ini entries:

[callback_foreman]
ssl_key = /etc/foreman/client_key.pem

[callback_foreman]
client_key = /etc/foreman/client_key.pem

env:FOREMAN_SSL_KEY
the corresponding private key

aliases: ssl_key
disable_callback
string
Default:
0
env:FOREMAN_CALLBACK_DISABLE
Toggle to make the callback plugin disable itself even if it is loaded.
It can be set to '1' to prevent the plugin from being used even if it gets loaded.
url
string / required
Default:
"http://localhost:3000"
ini entries:

[callback_foreman]
url = http://localhost:3000

env:FOREMAN_URL
env:FOREMAN_SERVER_URL
env:FOREMAN_SERVER
URL of the Foreman server.
verify_certs
string
Default:
1
ini entries:

[callback_foreman]
verify_certs = 1

env:FOREMAN_SSL_VERIFY
Toggle to decide whether to verify the Foreman certificate.
It can be set to '1' to verify SSL certificates using the installed CAs or to a path pointing to a CA bundle.
Set to '0' to disable certificate checking.