voxpupuli/puppet-module

Name: puppet-module

Owner: Vox Pupuli

Description: Puppet 4+ module to optionally configure and manage Puppet 4/5 package, config, agent, cert, and other tools.

Created: 2017-02-07 23:58:49.0

Updated: 2018-01-06 01:46:48.0

Pushed: 2018-05-22 19:50:44.0

Homepage:

Size: 31

Language: Puppet

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Puppet Configuration

Manage Puppet 4/5+ apply, agent, certificate, and other Puppet tools configuration.

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with puppet
   • What puppet affects
   • Setup requirements
   • Beginning with puppet
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

This module utilizes Hiera hierarchies to customize Puppet configuration for all three commands:

• …etc

Module Description

Configures Puppet 4/5+ agent, user tools, etc.

• Manages the Puppet yum repositories (if desired)
• Upgrades the puppet-agent package (if desired)
• Performs single-option configuration changes allowing local customizations to remain
• Strives to demonstrate Puppet best practices.

Setup

What puppet affects

• Yumrepo
• Puppet package repository
• Packages
• Puppet package
• Configuration Files
• /etc/puppetlabs/puppet/puppet.conf

Setup Requirements

Requires the puppet-agent package to be installed. (catch-22 yes I know)

Beginning with puppet

Hiera configuration:

classes:
  - puppet
  - puppet::agent (optional)

Usage

Configuration values in Hiera (or supplied by an node terminus):

• Common
• puppet::package_name = Override the default puppet-agent package name (for custom packages)
• puppet::manage_repo = Boolean to manage the yum repo for the specified Puppet version
• puppet::repo_enabled = Boolean to enable the repo for all Yum commands
• puppet::repos = hash to override the public repo with a local mirror
• puppet::version = 'latest', 'present', 'absent', or a specific version.
• puppet::config = Hash of configuration parameters for the [main] section of puppet.conf
• puppet::user::config = Hash of configuration parameters for the [user] section of puppet.conf
• Agent
• puppet::agent::status = 'Running' (default) or 'Stopped'
• puppet::agent::enabled = true (default) or false
• puppet::agent::config = Hash of configuration parameters for the [agent] section of puppet.conf

Reference

Setup Requirements

• Classes
• puppet - Maintains package repository, puppet package, and [main] block of puppet.conf
• puppet::user - Maintains [user] block of puppet.conf
• puppet::agent - Maintains [agent] block of puppet.conf and the puppet service