Skip to content
This repository

Example(42) complete set of Puppet Modules

branch: master
Octocat-spinner-32 Example42-documentation @ fc40709 Submodules updates November 07, 2013
Octocat-spinner-32 Example42-templates @ 28c6bee Updates October 25, 2013
Octocat-spinner-32 Example42-tools @ 563261f Updates November 27, 2013
Octocat-spinner-32 Example42-tutorials @ 2d049b1 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 activemq @ 6f395e6 Updated activemq v2.0.13 October 25, 2013
Octocat-spinner-32 apache @ e773d01 Updated apache v2.1.7 April 02, 2014
Octocat-spinner-32 apt @ 3ce35bf Updated apt v2.0.5 March 11, 2014
Octocat-spinner-32 auth @ 5d50583 Submodules updates November 07, 2013
Octocat-spinner-32 autofs @ 4400fc0 Updated autofs v2.0.13 October 25, 2013
Octocat-spinner-32 bacula @ b3bcc03 Updated external submodules March 11, 2014
Octocat-spinner-32 bind @ 9994273 Submodules updates November 07, 2013
Octocat-spinner-32 bluepill @ a847aec Updated submodules September 03, 2013
Octocat-spinner-32 bundler @ 8b30e27 Updated bundler v2.0.13 October 25, 2013
Octocat-spinner-32 ceilometer @ c8b418c Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 ceph @ ad73cb4 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 cinder @ 72b5b14 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 clvm @ 9afe62f Updated clvm v2.0.13 October 25, 2013
Octocat-spinner-32 collectd @ d3e70df Updated collectd v3.0.5 March 11, 2014
Octocat-spinner-32 concat @ cd2e1d9 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 corosync @ 8098d70 Submodules updates December 15, 2013
Octocat-spinner-32 ddclient @ 4263d5c Submodules updates November 07, 2013
Octocat-spinner-32 dhcpd @ 73a05c7 Updated dhcpd v2.0.14 March 11, 2014
Octocat-spinner-32 django @ 20207a4 Submodules updates November 07, 2013
Octocat-spinner-32 dnsmasq @ 560f39b Submodules updates November 07, 2013
Octocat-spinner-32 dovecot @ b0c324b Submodules updates December 15, 2013
Octocat-spinner-32 elasticsearch @ 9a179bd Updated elasticsearch v2.0.14 October 25, 2013
Octocat-spinner-32 example42 @ f85e1b1 Updated submodules December 15, 2013
Octocat-spinner-32 exim @ 05177ea Updated exim v2.0.13 October 25, 2013
Octocat-spinner-32 exported_vars @ 74b2931 Updated exported_vars v0.0.3 October 25, 2013
Octocat-spinner-32 firewall @ acbf2ee Updated firewall v2.1.3 October 25, 2013
Octocat-spinner-32 foreman @ eb7f46a Submodules updates December 15, 2013
Octocat-spinner-32 freeradius @ 972d6b7 Updated freeradius v2.0.11 October 25, 2013
Octocat-spinner-32 git @ 6ce218e Updated git v2.0.15 November 22, 2013
Octocat-spinner-32 glance @ 7110b80 Updated submodules December 15, 2013
Octocat-spinner-32 graylog2 @ a7e8f01 Submodules updates December 15, 2013
Octocat-spinner-32 haproxy @ 885bb17 Submodules updates December 15, 2013
Octocat-spinner-32 heartbeat @ e9d2ff3 Updated heartbeat v2.0.11 October 25, 2013
Octocat-spinner-32 hosts @ 6b633e5 Updated submodules December 15, 2013
Octocat-spinner-32 icinga @ 0590639 Submodules updates December 15, 2013
Octocat-spinner-32 iptables @ c0d290b Updated submodules December 15, 2013
Octocat-spinner-32 java @ 85e76cb Updated java v2.0.3 October 25, 2013
Octocat-spinner-32 jboss @ 47415b3 Submodules updates December 15, 2013
Octocat-spinner-32 jenkins @ f8c011e Submodules updates November 07, 2013
Octocat-spinner-32 keystone @ 49d685b Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 kibana @ 545a486 Updated submodules December 15, 2013
Octocat-spinner-32 libvirt @ 0b1ccf4 Updated libvirt v2.0.9 October 25, 2013
Octocat-spinner-32 lighttpd @ 770f3d5 Updated lighttpd v2.0.10 October 25, 2013
Octocat-spinner-32 limits @ 8198d96 Updated apache v2.1.6 March 11, 2014
Octocat-spinner-32 logrotate @ 37e83ed Updated logrotate v2.0.14 February 26, 2014
Octocat-spinner-32 logstash @ edb884e Updated logstash v2.0.10 October 25, 2013
Octocat-spinner-32 lsb @ 3a39d2a Submodules updates November 07, 2013
Octocat-spinner-32 mailx @ 5651dfc Updated mailx v2.0.13 October 25, 2013
Octocat-spinner-32 mariadb @ df35d72 Fix notify on conf define November 29, 2013
Octocat-spinner-32 maven @ 8a3a2e4 Submodules updates November 07, 2013
Octocat-spinner-32 mcollective @ 4218e00 Updated mcollective v2.0.13 March 19, 2014
Octocat-spinner-32 memcached @ 6f46735 Updated memcached v3.0.4 November 25, 2013
Octocat-spinner-32 module_data @ dbfe2bd Updated external submodules March 11, 2014
Octocat-spinner-32 mongodb @ 221131a Updated submodules December 15, 2013
Octocat-spinner-32 monit @ 4152cf9 Updated submodules November 15, 2013
Octocat-spinner-32 monitor @ 9e2bfb9 Updated submodules November 19, 2013
Octocat-spinner-32 msmtp @ 75b4b42 Updated external submodules March 11, 2014
Octocat-spinner-32 multipath @ b696524 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 munin @ b0ca156 Updated munin v2.0.11 April 04, 2014
Octocat-spinner-32 mysql @ b2d5fbc Updated mysql v2.1.3 February 28, 2014
Octocat-spinner-32 nagios @ 5da66e3 Updated nagios v2.0.15 February 28, 2014
Octocat-spinner-32 network @ 28c2914 Updated network v3.1.5 April 04, 2014
Octocat-spinner-32 newrelic @ 27dba47 Submodules updates November 07, 2013
Octocat-spinner-32 nfs @ 5fdf232 Updated nfs v2.0.13 October 25, 2013
Octocat-spinner-32 nginx @ 594f3b8 Updated external submodules March 11, 2014
Octocat-spinner-32 nova @ 605f6b9 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 nrpe @ 0acf541 Updates November 27, 2013
Octocat-spinner-32 ntp @ eb2cc48 Updated ntp v2.0.9 October 25, 2013
Octocat-spinner-32 nut @ 58df4d3 Submodules updates November 07, 2013
Octocat-spinner-32 openntpd @ f06011f Updated openntpd v2.0.8 October 25, 2013
Octocat-spinner-32 openssh @ c23c3de Updated openssh v2.0.9 October 25, 2013
Octocat-spinner-32 openvpn @ 5212f06 Updated openvpn v2.0.10 February 11, 2014
Octocat-spinner-32 openvswitch @ aa43ec0 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 orientdb @ ec6e976 Updated orientdb v2.0.8 October 25, 2013
Octocat-spinner-32 pacemaker @ 6a38411 Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 pam @ 9728aff Updated pam v2.0.13 October 25, 2013
Octocat-spinner-32 pentaho @ 27a7a04 Submodules updates November 07, 2013
Octocat-spinner-32 perl @ 0509fc1 Updated perl v2.0.16 October 25, 2013
Octocat-spinner-32 php @ c085ab9 Updated php v2.0.18 March 11, 2014
Octocat-spinner-32 postfix @ 34ccf89 Updated postfix v2.0.11 February 11, 2014
Octocat-spinner-32 postgresql @ 16e0c91 Submodules updates December 15, 2013
Octocat-spinner-32 profile @ d0a2f95 Updated profile v2.0.3 October 25, 2013
Octocat-spinner-32 proftpd @ 3808011 Updated proftpd v2.0.10 October 25, 2013
Octocat-spinner-32 pupmod-concat @ cd9a5b0 Submodules updates November 07, 2013
Octocat-spinner-32 puppet @ 22d594f Updated puppet v2.0.17 March 19, 2014
Octocat-spinner-32 puppet-skeleton-standard42 @ 79f7189 Removed mac non printing chars November 22, 2013
Octocat-spinner-32 puppetdashboard @ d26a07e Submodules updates December 15, 2013
Octocat-spinner-32 puppetdb @ 2894315 Updated puppetdb v2.0.12 February 11, 2014
Octocat-spinner-32 puppi @ 89dc156 Updated puppi v2.1.9 March 15, 2014
Octocat-spinner-32 quantum @ 0dcbbda Updated submodules not published on the Forge March 11, 2014
Octocat-spinner-32 rabbitmq @ be876ee Updated submodules November 10, 2013
Octocat-spinner-32 rclocal @ a34be2d Updated rclocal v2.0.5 October 25, 2013
Octocat-spinner-32 redis @ 6add9e9 Updated redis v2.0.8 October 25, 2013
Octocat-spinner-32 resolver @ 83dd1f4 Updated resolver v2.0.11 March 11, 2014
Octocat-spinner-32 rhcs @ c174594 Updated rhcs v2.0.13 October 25, 2013
Octocat-spinner-32 rsync @ cb4050c Updated rsync v2.0.11 March 07, 2014
Octocat-spinner-32 rsyncssh @ 2c7e10b Submodules updates November 07, 2013
Octocat-spinner-32 rsyslog @ e94cbeb Submodules updates November 07, 2013
Octocat-spinner-32 ruby @ 224c54f Updated ruby v2.0.13 October 25, 2013
Octocat-spinner-32 rvm @ 6915ba7 Submodules updates November 07, 2013
Octocat-spinner-32 samba @ f1d714c Updated samba v2.0.14 October 25, 2013
Octocat-spinner-32 scmserver @ eba9e8d Submodules updates November 07, 2013
Octocat-spinner-32 sendmail @ 0546e2f Submodules updates December 15, 2013
Octocat-spinner-32 snmpd @ 333a4d8 Updated snmpd v2.0.11 October 25, 2013
Octocat-spinner-32 solr @ 0ba6fd4 Removed mac non printing chars November 22, 2013
Octocat-spinner-32 splunk @ 303b2fc Updated splunk v2.0.11 February 11, 2014
Octocat-spinner-32 ssmtp @ 8e11519 Updated external submodules March 11, 2014
Octocat-spinner-32 stdlib @ e467d8f Updated external submodules March 11, 2014
Octocat-spinner-32 stdmod @ cb5d2f5 Updated stdmod v0.0.4 March 11, 2014
Octocat-spinner-32 sudo @ 5d56e15 Updated sudo v2.0.12 March 07, 2014
Octocat-spinner-32 svn @ 2fc2453 Submodules updates December 15, 2013
Octocat-spinner-32 sysctl @ ac9d11c Updated sysctl v2.0.14 February 11, 2014
Octocat-spinner-32 sysklogd @ 51b8547 Updated sysklogd v2.0.13 October 25, 2013
Octocat-spinner-32 syslog-ng @ 02da6ae Submodules updates November 07, 2013
Octocat-spinner-32 tartarus @ 5d47e48 Submodules updates November 07, 2013
Octocat-spinner-32 tcpwrappers @ 64d8daf Added Netmanagers tcpwrappers module September 25, 2013
Octocat-spinner-32 tftp @ 425734b Updated submodules November 19, 2013
Octocat-spinner-32 timezone @ a4f0217 Updated timezone v2.0.10 October 25, 2013
Octocat-spinner-32 tinc @ e8719a2 Updated tinc v2.0.12 October 25, 2013
Octocat-spinner-32 tomcat @ e77aad5 Updated tomcat v2.1.5 February 11, 2014
Octocat-spinner-32 unicorn @ 798af93 Submodules updates November 07, 2013
Octocat-spinner-32 user @ 1591a42 Use module March 11, 2014
Octocat-spinner-32 vagrant @ 77e43a6 Updated vagrant v2.0.12 March 11, 2014
Octocat-spinner-32 varnish @ 646c4a7 Updated external submodules March 11, 2014
Octocat-spinner-32 vim @ dd3eda1 Updated vim v2.0.12 March 07, 2014
Octocat-spinner-32 vsftpd @ ceb0cb5 Updated vsftpd v2.0.12 October 25, 2013
Octocat-spinner-32 wget @ 20348cf Submodules updates November 07, 2013
Octocat-spinner-32 wordpress @ 83142aa Updated wordpress v2.0.7 October 25, 2013
Octocat-spinner-32 xinetd @ 5f177fa Updated xinetd v2.0.8 October 25, 2013
Octocat-spinner-32 yum @ 01c8c53 Updated yum v2.1.10 March 07, 2014
Octocat-spinner-32 zip @ a9d7651 Updated zip v2.0.13 October 25, 2013
Octocat-spinner-32 .gitignore Updated Geppetto project file October 25, 2013
Octocat-spinner-32 .gitmodules Updated apache v2.1.6 March 11, 2014
Octocat-spinner-32 LICENSE Updated Example42 license to Apache2 (we follow Puppet licensing) June 26, 2011
Octocat-spinner-32 README.md Add a Bitdeli badge to README December 02, 2013
Octocat-spinner-32 Rakefile No rspec tests on stdlib. For real January 14, 2012
Octocat-spinner-32 example42only_list.txt Updated example42only_list.txt November 19, 2013
README.md

EXAMPLE42 PUPPET MODULES

Released under the terms of Apache2 licence.

Copyright Alessandro Franceschi / Lab42 (and specific commits authors)

Official website: http://www.example42.com

Official Support forum: Google Groups

IMPORTANT NOTICE:

Example42 modules have been delevoped over the years following Puppet's evolution.

There are currently 3 generations of example42 modules:

  • "OLD" modules (Version 1.x) are no more supported or recommended. They are supposed to work also on Puppet versions before 2.6 You can give them a look using the 1.0 branch of this repo.

  • "NextGen" modules (Version 2.x) are currently the most used and recommended. They are compatible only with Puppet version 2.6 and later. You find them here as git submodules.

  • "StdMod" modules (Version 3.x) are the next evolution of Example42 modules. They are going to adhere to StdMod naming standards and be compatible with Puppet > 2.7 or 3.x They are currently under development and testing, you find them here as git submodules

INSTALLATION

You can retrieve the Example42 modules Version 1.0 ("OLD") with:

git clone --recursive -b 1.0 git://github.com/example42/puppet-modules.git

You can get the current module set, with both NextGen and StdMod modules with:

git clone --recursive git://github.com/example42/puppet-modules.git

You can use the Puppet Playground to test these (and other) modules on a safe Vagrant environment.

From September 2013 most of the modules are published, and regularly updated, on the Puppet Forge.

Use the Puppet module tool to query and install Example42 modules:

    puppet module search example42

UPDATE

When you want to update the modules with the upstream version remember that also the submodules have to be updated:

cd /etc/puppet/modules # Or the dir where you have your local git repo

git pull origin master
git submodule init
git submodule update

If you want to force an update on each submodule, even if not tracked on the main repo:

git submodule foreach git pull origin master

The above commands (excluded the first cd and included the last) are done by the script:

Example42-tools/sync.sh

** DO NOT UPDATE IN PRODUCTION !!! ** To preserve freedom to reorganize modules and keep them updated this repo is going to keep track of the most current versions of the various modules. This can introduce backwards incompatibilities when a module is converted to the new major version (for example when 1.x have been completely removed or 2.x modules are converted to 3.x).

DEPENDENCIES

All the modules have a Modulefile where dependencies are described.

All the NextGen module require the presence in the $modulepath of the 'puppi' module, but you are not required to use Puppi (the dependency is for some extra functions prresent in the puppi module, which can be used even without including puppi in your manifests).

The StdMod modules require PuppetLabs' stdlib.

Most of the modules have a limited set of dependencies and, in some cases, you can pass a specific option (install_dependencies => false) to skip the inclusion of dependent classes from the Example42 set (in these cases you are supposed to provide the same resources in other ways).

If you enable the monitor or firewall options you have to include the relevant modules: respectively, monitor + the used monitor tool and firewall + iptables.

OPERATING SYSTEMS SUPPORT

Currently most of the modules are tested on the following Operating systems:

  • RedHat / Centos versions 5 and 6

  • Scientific Linux version 6

  • Debian 6 and 7

  • Ubuntu 10.04 and 12.04

Some of the modules have support for:

  • OpenSuse 11 and 12

  • Suse Enterprise Linux 11

  • Solaris 11

Most of the modules are expected to work on:

  • Amazon Linux 3

  • Fedora

  • Mint

If you need support or better testing for specific operating systems and versions the best thing you can do is to provide an usable Vagrant Base box for the Example42 Puppet Playground.

CONTRIBUTE

Pull requests via GitHub are welcomed, please review the general style and logic of the modules in order to submit consistent patches. These modules are intended to be used anywhere without any modification of their content: if you have to change them to suit your needs either they have some bugs or missing features or you're using them in the wrong way.

Please provide patches puppet-lint compliant and, where possible, provide rspec unit tests.

If you have a module not present in this set based on the Example42 templates, feel free to provide a a link to its repo url, we can add it as submodule.

DIFFERENCES BETWEEN VERSIONS

2.x modules are compatible only with Puppet versions > 2.6.

They are also compliant with Puppet 3.0, when dynamic variables scoping is going to be be discontinued.

These modules can be used with the "set variables and include the class" pattern or can be used as parametrized classes.

The main difference for the first approach is that only top scope variables can be used (so either set them in a ENC or use tools like Hiera to give them the values you need according to custom conditions).

2.x modules allow much cleaner and separated customizations so that you hardly need to modify them in order to add custom resources or redefine existing ones.

Decommissioning of classes is now done via top scope variables or arguments of the main class (absent, disable, disableboot) and not including the relevant sub-class.

Monitoring and firewalling abstraction and Puppi integration are still present, while backup abstraction has been discontinued.

3.x modules have these differences:

  • params_lookup function is removed, use Puppet 3 data bindings to data input alternatives

  • some parameters names are changed, according to stdmod namings

Modules code, issue tracking and features requests are on GitHub

For questions, suggestions and general discussion use the Example42 Puppet Modules Google group

If you need a specific module, improvements or conversion to 3.x of an existing one consider the possibility to sponsor it

Alessandro Franceschi Lab42

Bitdeli Badge

Something went wrong with that request. Please try again.