https://github.com/magmax/puppet-supervisord

Supervisord module for puppet
https://github.com/magmax/puppet-supervisord

Last synced: 13 days ago
JSON representation

Supervisord module for puppet

• Host: GitHub
• URL: https://github.com/magmax/puppet-supervisord
• Owner: magmax
• Created: 2014-01-27T08:57:54.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-01-27T18:20:41.000Z (almost 11 years ago)
• Last Synced: 2024-10-11T14:34:58.258Z (about 1 month ago)
• Language: Puppet
• Size: 133 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Puppet module: supervisord

This is a Puppet module for supervisord based on the second generation layout ("NextGen") of Example42 Puppet Modules.

Made by Miguel Angel García

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

Official git repository: http://github.com/example42/puppet-supervisord

Released under the terms of Apache 2 License.

This module requires functions provided by the Example42 Puppi module (you need it even if you don't use and install Puppi)

For detailed info about the logic and usage patterns of Example42 modules check the DOCS directory on Example42 main modules set.

## USAGE - Basic management

* Install supervisord with default settings

        class { 'supervisord': }

* Install a specific version of supervisord package

        class { 'supervisord':

          version => '1.0.1',

        }

* Disable supervisord service.

        class { 'supervisord':

          disable => true

        }

* Remove supervisord package

        class { 'supervisord':

          absent => true

        }

* Enable auditing without without making changes on existing supervisord configuration *files*

        class { 'supervisord':

          audit_only => true

        }

* Module dry-run: Do not make any change on *all* the resources provided by the module

        class { 'supervisord':

          noops => true

        }

## USAGE - Overrides and Customizations

* Use custom sources for main config file

        class { 'supervisord':

          source => [ "puppet:///modules/example42/supervisord/supervisord.conf-${hostname}" , "puppet:///modules/example42/supervisord/supervisord.conf" ],

        }

* Use custom source directory for the whole configuration dir

        class { 'supervisord':

          source_dir       => 'puppet:///modules/example42/supervisord/conf/',

          source_dir_purge => false, # Set to true to purge any existing file not present in $source_dir

        }

* Use custom template for main config file. Note that template and source arguments are alternative.

        class { 'supervisord':

          template => 'example42/supervisord/supervisord.conf.erb',

        }

* Automatically include a custom subclass

        class { 'supervisord':

          my_class => 'example42::my_supervisord',

        }

## USAGE - Example42 extensions management

* Activate puppi (recommended, but disabled by default)

        class { 'supervisord':

          puppi    => true,

        }

* Activate puppi and use a custom puppi_helper template (to be provided separately with a puppi::helper define ) to customize the output of puppi commands

        class { 'supervisord':

          puppi        => true,

          puppi_helper => 'myhelper',

        }

* Activate automatic monitoring (recommended, but disabled by default). This option requires the usage of Example42 monitor and relevant monitor tools modules

        class { 'supervisord':

          monitor      => true,

          monitor_tool => [ 'nagios' , 'monit' , 'munin' ],

        }

* Activate automatic firewalling. This option requires the usage of Example42 firewall and relevant firewall tools modules

        class { 'supervisord':

          firewall      => true,

          firewall_tool => 'iptables',

          firewall_src  => '10.42.0.0/24',

          firewall_dst  => $ipaddress_eth0,

        }

## CONTINUOUS TESTING

Travis {}[https://travis-ci.org/example42/puppet-supervisord]