Forge Home

puppet

pdk
manage puppet.conf, puppet runs

tskirvin

tskirvin

14,572 downloads

1,690 latest version

4.8 quality score

Version information

  • 1.4.3 (latest)
  • 1.4.2
  • 1.4.1
  • 1.4.0
  • 1.3.2
  • 1.3.1
  • 1.3.0
  • 1.2.0
  • 1.1.1
  • 1.1.0
  • 1.0.0
released Feb 26th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 7.0.0
  • Scientific, RedHat, Debian

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this declaration to your Puppetfile:

mod 'tskirvin-puppet', '1.4.3'
Learn more about managing modules with a Puppetfile

Add this module to a Bolt project:

bolt module add tskirvin-puppet
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install tskirvin-puppet --version 1.4.3

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

tskirvin/puppet — version 1.4.3 Feb 26th 2020

puppet-puppet

This puppet module is meant to manage /etc/puppet/puppet.conf and its family. It provides hooks for rsyslog + logrotate, and is configurable via hiera.

This module began life as a merge between some old puppet code, the ghoneycutt puppet module, and a lot of local custom work. It's currently in production across at least two sites, one large (~2700 nodes) and one small (~3 nodes).

Classes

puppet::agent

Manages the puppet agent. This means either running the service as a daemon (default), or via cron on a regular basis.

Parameters:

cron_command      Command to run if we are running via cron.  There is a
                   default, and I do not use it much so somebody should
                   look at it in more detail.
cron_user         User to run the cronjob as; defaults to 'root'.
cron_run_at_boot  Set this if you're running in 'cron' mode.
cron_run_in_noop  If set, we won't actually make any changes.  Defaults to
                   false.
cron_run_interval If running via cron, how often should we run?  Defaults
                   to 30 (minutes).
cron_earliest_hour Don't run the cronjob before this hour (except for boot)
cron_latest_hour   Don't run the cronjob after this hour (except for boot)

daemon_name      If we are running as a daemon, what is the daemon name?
                  Defaults to 'puppet'.
run_method       Pick one of: 'service' or 'cron'; default is 'service'

puppet::config

Manages /etc/puppet/puppet.conf. It is meant for configuration via hiera. There are puppet-strings-compatible docs included; a few specific useful parameters should provide some flavor:

agent        Should we configure the puppet agent variables?
             Defaults to true.
certname     Maps to the certname field in [main].  Defaults to $::fqdn.
enc          Are we using an external node classifier?  If so, set
             this to the right script name.  Defaults to 'false'.
env          Default puppet environment; required.
env_timeout  180 (seconds)
is_ca        Am I the Certificate Authority?  Corresponds to the 'ca'
             field.  Defaults to false.
log_level    What severity should puppet use?  Defaults to 'notice'.
master       Should we configure the puppet master variables?
             Defaults to false.
no_warnings  Array of strings from which to ignore warnings; maps to the
             'disable_warnings' field.  Empty by default.
runinterval  How often should the puppet daemon run?  Defaults to unset.
runtimeout   What is the max runtime any catalog should have?
run_in_noop  If set, don't make any changes with a puppet run.
             Defaults to false.
server       The main puppet server name.  Required, no default.
splaylimit   How much random time should we add to runinterval?
             Defaults to unset.
strict       https://puppet.com/docs/puppet/5.5/configuration.html#strict
use_puppetdb If set, turns on puppetdb for storeconfigs.  Defaults
             to off.

puppet::puppetserver, puppet::puppetserver::java

Start the puppetserver process. Currently not very configurable.

puppet::syslog

Set up syslog to log to /var/log/puppet.log (configurable).

Prerequisites

  • puppetlabs/stdlib