Puppet 4.8 reference manual

The hiera.yaml file is used to configure Hiera, which Puppet can use to look up data.

Location

The hiera.yaml file is located at $confdir/hiera.yaml by default. Its location is configurable with the hiera_config setting.

When Puppet loads Hiera, it uses its own Hiera config file instead of the global one (which is usually located at /etc/hiera.yaml). If needed, you can point the hiera_config setting at the global Hiera config.

The location of the confdir depends on your OS. [See the codedir documentation for details.][confdir]

Example

---
:backends:
  - yaml
  - json
:yaml:
  :datadir: /etc/puppetlabs/puppet/hieradata
:json:
  :datadir: /etc/puppetlabs/puppet/hieradata
:hierarchy:
  - "%{clientcert}"
  - "%{datacenter}"
  - "%{osfamily}"
  - common

Format

See the Hiera documentation for full details about the hiera.yaml file.

Back to top