Puppet

Build Status

Table Of Contents

  1. Overview
  2. Module Description
  3. Usage
  4. Dependencies
  5. Contribution

Overview

Deploys and configures Puppet

Module Description

Lightweight puppet deployment. Performs only the most rudimentary installation tasks, configuration is up to the user. Configuration is performed entriely in hiera to cleanly separate code from data. Puppet defaults are typically sufficient to create a working setup.

Usage

include ::puppet::agent::cron
include ::puppet::master::apache
---
puppet::repo_manage: true

puppet::hiera: |
  :backends:
    - yaml
  :yaml:
    :datadir: "/etc/puppet/environments/%%{}{::environment}/hiera"
  :hierarchy:
    - "nodes/%%{}{::hostname}"
    - "modules/%%{}{calling_module}"
    - common

puppet::conf:
  main:
    logdir: '/var/lib/puppet'
    rundir: '/var/run/puppet'
    ssldir: '/var/lib/puppet/ssl'
  master:
    environmentpath: '$confdir/environments'

Please note the escape sequences in the puppet::hiera string as at present with foss hiera it will try interpolate %{} statements unconditionally

Dependencies

Contribution

I'm keen to keep this module lightweight and maintainable. As such, much is hard coded to Ubuntu, however most pertinent options can be controlled via parameters. Likewise there are no configuration related hacks, all configuration is passed in pretty much verbatim via parameters, so should never be changed.

That said if extensions are required ensure the changes are unit tested before submission. Please at least run:

rake validate
rake beaker