Ansible: Foreman Inventory Source

Archives Ansible Project
1

Hi,

Does anyone know how to configure the new Foreman Inventory Source plugin that ships with Ansible 2.6?

The documentation for it is here: https://docs.ansible.com/ansible/devel/plugins/inventory/foreman.html

But this does not even say which file the parameters are meant to be configured in. I’m guessing the first 4 go in ansible.cfg under the [inventory] heading, but I’m not sure where ‘url’ etc are meant to go.
My understanding of this plugin is that is will query the Foreman API and populate Ansible’s inventory with the hosts returned by Foreman.

Any help configuring this would be much appreciated.

Thanks!

2

Make a config file: foreman.ini and insert those inside that.

3

@Varun that is for the inventory script, he is asking for the
inventory plugin which is different.

@Wooly I'll update docs to add an example, but you just need a yaml
file that ends in '.foreman.yaml' or '.foreman.yml' with contents as
follows:

plugin: foreman
url: http(s)://<to foreman server>:<port>
user: <auth user for foreman>
password: <auth pass>

4

Hi Brian, thanks for the reply. Can you tell me when the plugin is meant to run? Is it at the start of any ansible run/command or does it need calling explicitly?

I have enable_plugins = foreman in the ansible.cfg file and the plugin file is as required. I’m just not sure how I tell if the plugin is trying to poll foreman or not.

Cheers,
Woolly

5

Add -i /path/to/my.foreman.yml and it should 'just work'tm. You can
use -vvv to see it working, otherwise you should get a warning.