Puppet Class: hiera

Inherits:
hiera::params
Defined in:
manifests/init.pp

Overview

Class: hiera

This class handles installing the hiera.yaml for Puppet’s use.

Parameters:

See README.

Actions:

Installs either /etc/puppet/hiera.yaml or /etc/puppetlabs/puppet/hiera.yaml. Links /etc/hiera.yaml to the above file. Creates $datadir (if $datadir_manage == true).

Requires:

puppetlabs-stdlib >= 4.3.1

Sample Usage:

class { 'hiera':
  hierarchy => [
    '%{environment}',
    'common',
  ],
}

Authors:

Hunter Haugen <h.haugen@gmail.com> Mike Arnold <mike@razorsedge.org> Terri Haber <terri@puppetlabs.com> Greg Kitson <greg.kitson@puppetlabs.com>

Copyright © 2012 Hunter Haugen, unless otherwise noted. Copyright © 2013 Mike Arnold, unless otherwise noted. Copyright © 2014 Terri Haber, unless otherwise noted.

Parameters:

  • hierarchy (Any) (defaults to: [])
  • backends (Any) (defaults to: ['yaml'])
  • hiera_yaml (Any) (defaults to: $hiera::params::hiera_yaml)
  • create_symlink (Any) (defaults to: true)
  • datadir (Any) (defaults to: $hiera::params::datadir)
  • datadir_manage (Any) (defaults to: true)
  • owner (Any) (defaults to: $hiera::params::owner)
  • group (Any) (defaults to: $hiera::params::group)
  • provider (Any) (defaults to: $hiera::params::provider)
  • eyaml (Any) (defaults to: false)
  • eyaml_datadir (Any) (defaults to: undef)
  • eyaml_extension (Any) (defaults to: undef)
  • confdir (Any) (defaults to: $hiera::params::confdir)
  • puppet_conf_manage (Any) (defaults to: true)
  • logger (Any) (defaults to: 'console')
  • cmdpath (Any) (defaults to: $hiera::params::cmdpath)
  • create_keys (Any) (defaults to: true)
  • keysdir (Any) (defaults to: undef)
  • gem_source (Any) (defaults to: undef)
  • eyaml_version (Any) (defaults to: undef)
  • merge_behavior (Any) (defaults to: undef)
  • extra_config (Any) (defaults to: '')
  • master_service (Any) (defaults to: $hiera::params::master_service) 


41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
 
# File 'manifests/init.pp', line 41

class hiera (
  $hierarchy          = [],
  $backends           = ['yaml'],
  $hiera_yaml         = $hiera::params::hiera_yaml,
  $create_symlink     = true,
  $datadir            = $hiera::params::datadir,
  $datadir_manage     = true,
  $owner              = $hiera::params::owner,
  $group              = $hiera::params::group,
  $provider           = $hiera::params::provider,
  $eyaml              = false,
  $eyaml_datadir      = undef,
  $eyaml_extension    = undef,
  $confdir            = $hiera::params::confdir,
  $puppet_conf_manage = true,
  $logger             = 'console',
  $cmdpath            = $hiera::params::cmdpath,
  $create_keys        = true,
  $keysdir            = undef,
  $gem_source         = undef,
  $eyaml_version      = undef,
  $merge_behavior     = undef,
  $extra_config       = '',
  $master_service     = $hiera::params::master_service,
) inherits hiera::params {
  warning('This module (hunner/hiera) has moved; see the readme.')
  if $keysdir {
    $_keysdir = $keysdir
  } else {
    $_keysdir = "${confdir}/keys"
  }
  File {
    owner => $owner,
    group => $group,
    mode  => '0644',
  }
  if ($datadir !~ /%\{.*\}/) and ($datadir_manage == true) {
    file { $datadir:
      ensure => directory,
    }
  }
  if $merge_behavior {
    unless $merge_behavior in ['native', 'deep', 'deeper'] {
      fail("${merge_behavior} merge behavior is invalid. Valid values are: native, deep, deeper")
    }
  }
  if $eyaml {
    require hiera::eyaml
    $eyaml_real_datadir = empty($eyaml_datadir) ? {
      false => $eyaml_datadir,
      true  => $datadir,
    }
  }
  # Template uses:
  # - $eyaml
  # - $backends
  # - $logger
  # - $hierarchy
  # - $datadir
  # - $eyaml_real_datadir
  # - $eyaml_extension
  # - $_keysdir
  # - $confdir
  # - $merge_behavior
  # - $extra_config
  file { $hiera_yaml:
    ensure  => present,
    content => template('hiera/hiera.yaml.erb'),
  }
  # Symlink for hiera command line tool
  if $create_symlink {
    file { '/etc/hiera.yaml':
      ensure => symlink,
      target => $hiera_yaml,
    }
  }
  if $puppet_conf_manage {
    ini_setting { 'puppet.conf hiera_config main section' :
      ensure  => present,
      path    => "${confdir}/puppet.conf",
      section => 'main',
      setting => 'hiera_config',
      value   => $hiera_yaml,
    }
    $master_subscribe = [
      File[$hiera_yaml],
      Ini_setting['puppet.conf hiera_config main section'],
    ]
  } else {
    $master_subscribe = File[$hiera_yaml]
  }

  # Restart master service
  Service <| title == $master_service |> {
    subscribe +> $master_subscribe,
  }
}