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 will use 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 varies; it depends on the OS, Puppet distribution, and user account. See the confdir documentation for details.
Example
---
:backends:
- yaml
- json
:yaml:
:datadir: /etc/puppet/hieradata
:json:
:datadir: /etc/puppet/hieradata
:hierarchy:
- "%{clientcert}"
- "%{datacenter}"
- "%{osfamily}"
- common
Format
See the Hiera documentation for full details about the hiera.yaml file.