#Puppet

####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
include ::puppet::server

---
puppet::repo_manage: true

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

puppet::conf:
  master:
    environmentpath: '$confdir/environments'

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

##Dependencies

• http://github.com/puppetlabs/puppetlabs-apt
• http://github.com/puppetlabs/puppetlabs-stdlib

If you are using the HAProxy load balancer class you will need

• http://github.com/puppetlabs/puppetlabs-concat
• http://github.com/puppetlabs/puppetlabs-haproxy

##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 lint
rake validate
rake beaker