Puppet Class: puppet

Defined in:
manifests/init.pp

Overview

Class: puppet

Performs common puppet setup functionality. Called implicitly from puppet::agent and puppet::master

Parameters

version

Version of the packages to install

package

Package to install e.g. puppet-common in apt is puppet in gem

provider

Where to source the packages from

path

Absolute path to the puppet binary for things like cron with restricted $PATH

dependencies

Additional package dependencies

conf

Puppet configuration file contents

conf_merge

Whether to merge configuration hash with hiera

hiera

Hiera configuration file contents

autosign

Array of autosign.conf entries

repo_manage

Whether to enable module control of the puppet apt repository

repo_location

Where the repository resides

repo_release

Release of the repository to use

repo_repos

The repositories to enable

repo_key

The GPG key fingerprint to accept

repo_key_source

Where to source the GPG key from

ssl

Whether a master node should use SSL

Notes

  • Chances are you are defining hiera in hiera, and as such any variable substitutions must be escaped. To generate the correct output for “‘modules/%calling_module“` you will need to specify the hiera input as “`modules/%%{}calling_module“`

  • PuppetLabs only support LTS, so for releases like utopic you will need to use the trusty release to get upstream packages

Parameters:

  • version (Any) (defaults to: 'installed')
  • package (Any) (defaults to: 'puppet-common')
  • provider (Any) (defaults to: 'apt')
  • path (Any) (defaults to: '/usr/bin/puppet')
  • dependencies (Any) (defaults to: [ 'ruby-shadow', ])
  • conf (Any) (defaults to: { 'main' => { 'logdir' => '/var/lib/puppet', 'vardir' => '/var/lib/puppet', 'ssldir' => '/var/lib/puppet/ssl', 'rundir' => '/var/run/puppet', }, 'agent' => { 'server' => $::fqdn, }, })
  • conf_merge (Any) (defaults to: false)
  • hiera (Any) (defaults to: '--- :backends: - yaml :yaml: :datadir: /var/lib/hiera :hierarchy: - "%{::hostname}" - "%{::environment}" - common ')
  • autosign_manage (Any) (defaults to: true)
  • autosign (Any) (defaults to: [])
  • repo_manage (Any) (defaults to: false)
  • repo_location (Any) (defaults to: 'http://apt.puppetlabs.com')
  • repo_release (Any) (defaults to: 'trusty')
  • repo_repos (Any) (defaults to: 'main dependencies')
  • repo_key (Any) (defaults to: '47B320EB4C7C375AA9DAE1A01054B7A24BD6EC30')
  • repo_key_source (Any) (defaults to: 'https://apt.puppetlabs.com/keyring.gpg')
  • ssl (Any) (defaults to: true)
  • server_gems (Any) (defaults to: []) 


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
 
# File 'manifests/init.pp', line 67

class puppet (
  # Version control
  $version = 'installed',
  $package = 'puppet-common',
  $provider = 'apt',
  $path = '/usr/bin/puppet',
  # Installation control
  $dependencies = [
    'ruby-shadow',
  ],
  # Configuration management
  $conf = {
    'main' => {
      'logdir' => '/var/lib/puppet',
      'vardir' => '/var/lib/puppet',
      'ssldir' => '/var/lib/puppet/ssl',
      'rundir' => '/var/run/puppet',
    },
    'agent' => {
      'server' => $::fqdn,
    },
  },
  $conf_merge = false,
  # Hiera management
  $hiera = '---
:backends:
  - yaml
:yaml:
  :datadir: /var/lib/hiera
:hierarchy:
  - "%{::hostname}"
  - "%{::environment}"
  - common
',
  # Autosign management
  $autosign_manage = true,
  $autosign = [],
  # Repository management
  $repo_manage = false,
  $repo_location = 'http://apt.puppetlabs.com',
  $repo_release = 'trusty',
  $repo_repos = 'main dependencies',
  $repo_key = '47B320EB4C7C375AA9DAE1A01054B7A24BD6EC30',
  $repo_key_source = 'https://apt.puppetlabs.com/keyring.gpg',
  # Master/server configuration
  $ssl = true,
  # Server gem configuration
  $server_gems = [],
) {

  contain ::puppet::repo
  contain ::puppet::config
  contain ::puppet::hiera
  contain ::puppet::install

}