This module adds a Task for performing hiera lookups.

For Puppet Enterprise users, this means you can allow users or admins to perform hiera lookups without giving them SSH access to your Puppet master! The ability to run this task remotely or via the Console is gated and tracked by the RBAC system built in to PE.

This module is compatible with Puppet Enterprise and Puppet Bolt.

• To run tasks with Puppet Enterprise, PE 2017.3 or later must be used.

• To run tasks with Puppet Bolt, Bolt 0.5 or later must be installed on the machine from which you are running task commands. The master receiving the task must have SSH enabled.

With Puppet Enterprise 2017.3 or higher, you can run this task from the console or the command line.

Here's a command line example where we are looking up ntp::servers from the Puppet master, master.corp.net:

[abir@workstation]$ puppet task run hiera_lookup keys=ntp::servers -n master.corp.net
Starting job ...
New job ID: 346
Nodes: 1

Started on master.corp.net ...
Finished on node master.corp.net
  STDOUT:
    key: ntp::servers
    ---
    - 0.us.pool.ntp.org
    - 1.us.pool.ntp.org
    - 2.us.pool.ntp.org
    - 3.us.pool.ntp.org
    -------------------------------------------

Job completed. 1/1 nodes succeeded.
Duration: 10 sec

With Bolt, you can run this task on the command line like so:

bolt task run hiera_lookup keys=ntp::servers --nodes master.corp.net

• keys: A comma-separated list of keys to look up
• environment: Environment to use for look up (optional)
• certname: Node to use for look up (optional)
• explain: Enable explain (optional). Defaults to no.