You are viewing docs from a branch that is no longer active. You might want to view docs for the 2015.8.x release instead.

salt.pillar.foreman¶

A module to pull data from Foreman via its API into the Pillar dictionary

Configuring the Foreman ext_pillar¶

Set the following Salt config to setup Foreman as external pillar source:

ext_pillar:
  - foreman:
      key: foreman # Nest results within this key
      only: ['hostgroup_name', 'parameters'] # Add only these keys to pillar

foreman.url: https://example.com/foreman_api
foreman.user: username # default is admin
foreman.password: password # default is changeme

The following options are optional:

foreman.api: apiversion # default is 2 (1 is not supported yet)
foreman.verifyssl: False # default is True
foreman.certfile: /etc/ssl/certs/mycert.pem # default is None
foreman.keyfile: /etc/ssl/private/mykey.pem # default is None
foreman.cafile: /etc/ssl/certs/mycert.ca.pem # default is None
foreman.lookup_parameters: True # default is True

Module Documentation¶

salt.pillar.foreman.ext_pillar(minion_id, pillar, key=None, only=())¶: Read pillar data from Foreman via its API.