Foreman and Ansible documentation improvements needed

Hello, Im following the documentation in order to setup a simple foreman enc for ansible, it seems to be things that just dont fit.

Taking fopreman 1.24 with plugin ansible 3.x : https://www.theforeman.org/plugins/foreman_ansible/3.x/index.html#2.Installation

You are told to set some configs at ansible.cfg

[defaults]
callback_whitelist = foreman

Also the call_back foreman is incorrect it should something like thjat , and should be noted that the right info can be found that way : egrep ‘ssl|port’ /etc/foreman-proxy/settings.yml | grep -v ‘^#’
[callback_foreman]
url = ‘https://foremanansible.mydomain.lab
ssl_cert = /etc/puppetlabs/puppet/ssl/certs/$(hostname -f)
ssl_key = /etc/puppetlabs/puppet/ssl/private_keys/$(hostname -f)
verify_certs = /etc/puppetlabs/puppet/ssl/certs/ca.pem

At point 4 the problems arise, it seems that the gif shows some configs that are not well documented (Ivebeen unablke to find docs for them) .

Also the line bin_ansible_callbacks=True should be noted before point 4

The ansible plugin for foreman (foreman_callback.py) seems to be represented with several diferent versions . For what I think the right version is that one :

It should be noted in the docs that you need to retrieve the foreman.py from github

1 Like

Hello, thanks for the report. Mind creating a PR in our documentation repo?