Add puppet module for monit

v0.0.4 412cd738a0fd94cbd337053b2a8562928988679a
source git@github.com:jbussdieker/puppet-monit.git

Related blueprint pacemaker-improvements

Change-Id: I76c5ae198ae355d0ddaeaa627a50e2c230e932b9
Signed-off-by: Bogdan Dobrelya <bdobrelia@mirantis.com>

deployment/puppet/monit/.gitignore

@@ -0,0 +1,2 @@
+vendor/
+.bundle/

deployment/puppet/monit/.travis.yml

@@ -0,0 +1,16 @@
+---
+script: 'rake spec'
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+env:
+  - PUPPET_VERSION=2.6.11
+  - PUPPET_VERSION=3.0.1
+  - PUPPET_VERSION=3.2.2
+matrix:
+  exclude:
+    - rvm: 1.9.2
+      env: PUPPET_VERSION=2.6.11
+    - rvm: 1.9.3
+      env: PUPPET_VERSION=2.6.11

deployment/puppet/monit/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+puppet_version = ENV.key?('PUPPET_VERSION') ? "= #{ENV['PUPPET_VERSION']}" : ['>= 2.7']
+
+gem 'rake'
+gem 'rspec'
+gem 'rspec-puppet'
+gem 'puppet', puppet_version
+gem 'puppetlabs_spec_helper'

deployment/puppet/monit/Modulefile

@@ -0,0 +1,5 @@
+name    'jbussdieker-monit'
+source  'git@github.com:jbussdieker/puppet-monit.git'
+author  'Joshua B. Bussdieker'
+summary 'Monit Module'
+version '0.0.4'

deployment/puppet/monit/README.md

@@ -0,0 +1,23 @@
+# Monit Module
+
+[![Build Status](https://travis-ci.org/jbussdieker/puppet-monit.png?branch=master)](https://travis-ci.org/jbussdieker/puppet-monit)
+
+This module manages installing, configuring and running processes using monit.
+
+http://forge.puppetlabs.com/jbussdieker/monit
+
+## Parameters
+
+ * ensure: running, stopped. default: running
+ * start_command: Command line to start service.
+ * stop_command: Command line to stop service.
+ * pidfile: Location to find the pid file.
+
+## Usage
+
+    monit::process {'myapp':
+      ensure        => running,
+      start_command => '/etc/init.d/myapp start',
+      stop_command  => '/etc/init.d/myapp stop',
+      pidfile       => '/var/run/myapp/myapp.pid',
+    }

deployment/puppet/monit/Rakefile

@@ -0,0 +1,9 @@
+require 'rake'
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/*/*_spec.rb'
+end
+
+task :default => :spec

deployment/puppet/monit/lib/puppet/provider/service/monit.rb

@@ -0,0 +1,25 @@
+Puppet::Type.type(:service).provide(:monit, :parent => Puppet::Provider) do
+  COMMAND = "/usr/bin/monit"
+
+  def status
+    results = `#{COMMAND} status`
+    procs = results.split("\n\n")
+    procs.each do |proc_info|
+      lines = proc_info.split("\n")
+      if lines[0].strip == "Process '#{resource[:name]}'"
+        status = lines[1].split(" ")[1..-1].join(" ")
+        return :stopped if status == "Not monitored"
+        return :running if status == "Running"
+      end
+    end
+    nil
+  end
+
+  def start
+    `#{COMMAND} start #{resource[:name]}`
+  end
+
+  def stop
+    `#{COMMAND} stop #{resource[:name]}`
+  end
+end

deployment/puppet/monit/manifests/config.pp

@@ -0,0 +1,11 @@
+class monit::config {
+
+  file {'/etc/monit/monitrc':
+    ensure  => present,
+    owner   => 'root',
+    group   => 'root',
+    mode    => 0600,
+    content => template('monit/monitrc.erb'),
+  }
+
+}

deployment/puppet/monit/manifests/init.pp

@@ -0,0 +1,16 @@
+class monit {
+
+  class {'monit::package':
+    notify  => Class['monit::service'],
+  }
+
+  class {'monit::config':
+    notify  => Class['monit::service'],
+    require => Class['monit::package'],
+  }
+
+  class {'monit::service':
+    require => Class['monit::config'],
+  }
+
+}

deployment/puppet/monit/manifests/package.pp

@@ -0,0 +1,7 @@
+class monit::package {
+
+  package {'monit':
+    ensure => present,
+  }
+
+}

deployment/puppet/monit/manifests/process.pp

@@ -0,0 +1,25 @@
+define monit::process(
+  $ensure="running",
+  $pidfile = '',
+  $start_command,
+  $stop_command) {
+
+  include monit
+
+  file {"/etc/monit/conf.d/${name}":
+    ensure  => present,
+    owner   => 'root',
+    group   => 'root',
+    content => template('monit/process.erb'),
+    notify  => Class['monit::service'],
+    require => Class['monit::package'],
+    before  => Service[$name],
+  }
+
+  service {$name:
+    ensure   => $ensure,
+    provider => 'monit',
+    require  => Service['monit'],
+  }
+
+}

deployment/puppet/monit/manifests/service.pp

@@ -0,0 +1,7 @@
+class monit::service {
+
+  service {'monit':
+    ensure => running,
+  }
+
+}

deployment/puppet/monit/spec/classes/config_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe 'monit::config' do
+  it { should contain_file('/etc/monit/monitrc') }
+end

deployment/puppet/monit/spec/classes/package_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe 'monit::package' do
+  it { should contain_package('monit') }
+end

deployment/puppet/monit/spec/classes/service_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe 'monit::service' do
+  it { should contain_service('monit') }
+end

deployment/puppet/monit/spec/defines/process_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe 'monit::process' do
+  let(:title) { 'testprocess' }
+
+  let(:params) { {
+    :start_command => 'start',
+    :stop_command => 'stop',
+    :pidfile => 'pidfile',
+  } }
+
+  describe 'configuration file' do
+    let(:filename) { "/etc/monit/conf.d/#{title}" }
+
+    it 'is declared' do
+      should contain_file(filename)
+    end
+
+    it 'requires monit to be installed' do
+      # can't very well create the configuration file when the directory that
+      # should contain it doesn't exist because monit has not yet been
+      # installed.
+      should contain_file(filename).that_requires('Class[monit::package]')
+    end
+
+    it 'comes before the monit service' do
+      should contain_file(filename).that_comes_before("Service[#{title}]")
+    end
+
+    it 'notifies the monit daemon' do
+      should contain_file(filename).that_notifies("Class[monit::service]")
+    end
+  end
+
+
+  describe 'monit service' do
+    it 'is declared' do
+      should contain_service(title).with_provider('monit')
+    end
+
+    it 'requires the monit daemon' do
+      should contain_service(title).that_requires('Service[monit]')
+    end
+  end
+end

deployment/puppet/monit/spec/fixtures/modules/monit/manifests

@@ -0,0 +1 @@
+../../../../manifests

deployment/puppet/monit/spec/fixtures/modules/monit/templates

@@ -0,0 +1 @@
+../../../../templates

deployment/puppet/monit/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rspec-puppet'
+
+fixture_path = File.expand_path(File.join(__FILE__, '..', 'fixtures'))
+
+RSpec.configure do |c|
+  c.module_path = File.join(fixture_path, 'modules')
+  c.manifest_dir = File.join(fixture_path, 'manifests')
+end

deployment/puppet/monit/templates/monitrc.erb

@@ -0,0 +1,248 @@
+###############################################################################
+## Monit control file
+###############################################################################
+##
+## Comments begin with a '#' and extend through the end of the line. Keywords
+## are case insensitive. All path's MUST BE FULLY QUALIFIED, starting with '/'.
+##
+## Below you will find examples of some frequently used statements. For 
+## information about the control file and a complete list of statements and 
+## options, please have a look in the Monit manual.
+##
+##
+###############################################################################
+## Global section
+###############################################################################
+##
+## Start Monit in the background (run as a daemon):
+#
+  set daemon 120            # check services at 2-minute intervals
+#   with start delay 240    # optional: delay the first check by 4-minutes (by 
+#                           # default Monit check immediately after Monit start)
+#
+#
+## Set syslog logging with the 'daemon' facility. If the FACILITY option is
+## omitted, Monit will use 'user' facility by default. If you want to log to 
+## a standalone log file instead, specify the full path to the log file
+#
+# set logfile syslog facility log_daemon                       
+  set logfile /var/log/monit.log
+#
+#
+## Set the location of the Monit id file which stores the unique id for the
+## Monit instance. The id is generated and stored on first Monit start. By 
+## default the file is placed in $HOME/.monit.id.
+#
+# set idfile /var/.monit.id
+  set idfile /var/lib/monit/id
+#
+## Set the location of the Monit state file which saves monitoring states
+## on each cycle. By default the file is placed in $HOME/.monit.state. If
+## the state file is stored on a persistent filesystem, Monit will recover
+## the monitoring state across reboots. If it is on temporary filesystem, the
+## state will be lost on reboot which may be convenient in some situations.
+#
+  set statefile /var/lib/monit/state
+#
+## Set the list of mail servers for alert delivery. Multiple servers may be 
+## specified using a comma separator. If the first mail server fails, Monit 
+# will use the second mail server in the list and so on. By default Monit uses 
+# port 25 - it is possible to override this with the PORT option.
+#
+# set mailserver mail.bar.baz,               # primary mailserver
+#                backup.bar.baz port 10025,  # backup mailserver on port 10025
+#                localhost                   # fallback relay
+#
+#
+## By default Monit will drop alert events if no mail servers are available. 
+## If you want to keep the alerts for later delivery retry, you can use the 
+## EVENTQUEUE statement. The base directory where undelivered alerts will be 
+## stored is specified by the BASEDIR option. You can limit the maximal queue
+## size using the SLOTS option (if omitted, the queue is limited by space 
+## available in the back end filesystem).
+#
+  set eventqueue
+      basedir /var/lib/monit/events # set the base directory where events will be stored
+      slots 100                     # optionally limit the queue size
+#
+#
+## Send status and events to M/Monit (for more informations about M/Monit 
+## see http://mmonit.com/). By default Monit registers credentials with 
+## M/Monit so M/Monit can smoothly communicate back to Monit and you don't
+## have to register Monit credentials manually in M/Monit. It is possible to
+## disable credential registration using the commented out option below. 
+## Though, if safety is a concern we recommend instead using https when
+## communicating with M/Monit and send credentials encrypted.
+#
+# set mmonit http://monit:monit@192.168.1.10:8080/collector
+#     # and register without credentials     # Don't register credentials
+#
+#
+## Monit by default uses the following format for alerts if the the mail-format
+## statement is missing::
+## --8<--
+## set mail-format {
+##      from: monit@$HOST
+##   subject: monit alert --  $EVENT $SERVICE
+##   message: $EVENT Service $SERVICE
+##                 Date:        $DATE
+##                 Action:      $ACTION
+##                 Host:        $HOST
+##                 Description: $DESCRIPTION
+##
+##            Your faithful employee,
+##            Monit
+## }
+## --8<--
+##
+## You can override this message format or parts of it, such as subject
+## or sender using the MAIL-FORMAT statement. Macros such as $DATE, etc.
+## are expanded at runtime. For example, to override the sender, use:
+#
+# set mail-format { from: monit@foo.bar }
+#
+#
+## You can set alert recipients whom will receive alerts if/when a 
+## service defined in this file has errors. Alerts may be restricted on 
+## events by using a filter as in the second example below. 
+#
+# set alert sysadm@foo.bar                       # receive all alerts
+# set alert manager@foo.bar only on { timeout }  # receive just service-
+#                                                # timeout alert
+#
+#
+## Monit has an embedded web server which can be used to view status of 
+## services monitored and manage services from a web interface. See the
+## Monit Wiki if you want to enable SSL for the web server. 
+#
+# set httpd port 2812 and
+#    use address localhost  # only accept connection from localhost
+#    allow localhost        # allow localhost to connect to the server and
+#    allow admin:monit      # require user 'admin' with password 'monit'
+#    allow @monit           # allow users of group 'monit' to connect (rw)
+#    allow @users readonly  # allow users of group 'users' to connect readonly
+#
+###############################################################################
+## Services
+###############################################################################
+##
+## Check general system resources such as load average, cpu and memory
+## usage. Each test specifies a resource, conditions and the action to be
+## performed should a test fail.
+#
+#  check system myhost.mydomain.tld
+#    if loadavg (1min) > 4 then alert
+#    if loadavg (5min) > 2 then alert
+#    if memory usage > 75% then alert
+#    if swap usage > 25% then alert
+#    if cpu usage (user) > 70% then alert
+#    if cpu usage (system) > 30% then alert
+#    if cpu usage (wait) > 20% then alert
+#
+#    
+## Check if a file exists, checksum, permissions, uid and gid. In addition
+## to alert recipients in the global section, customized alert can be sent to 
+## additional recipients by specifying a local alert handler. The service may 
+## be grouped using the GROUP option. More than one group can be specified by
+## repeating the 'group name' statement.
+#    
+#  check file apache_bin with path /usr/local/apache/bin/httpd
+#    if failed checksum and 
+#       expect the sum 8f7f419955cefa0b33a2ba316cba3659 then unmonitor
+#    if failed permission 755 then unmonitor
+#    if failed uid root then unmonitor
+#    if failed gid root then unmonitor
+#    alert security@foo.bar on {
+#           checksum, permission, uid, gid, unmonitor
+#        } with the mail-format { subject: Alarm! }
+#    group server
+#
+#    
+## Check that a process is running, in this case Apache, and that it respond
+## to HTTP and HTTPS requests. Check its resource usage such as cpu and memory,
+## and number of children. If the process is not running, Monit will restart 
+## it by default. In case the service is restarted very often and the 
+## problem remains, it is possible to disable monitoring using the TIMEOUT
+## statement. This service depends on another service (apache_bin) which
+## is defined above.
+#    
+#  check process apache with pidfile /usr/local/apache/logs/httpd.pid
+#    start program = "/etc/init.d/httpd start" with timeout 60 seconds
+#    stop program  = "/etc/init.d/httpd stop"
+#    if cpu > 60% for 2 cycles then alert
+#    if cpu > 80% for 5 cycles then restart
+#    if totalmem > 200.0 MB for 5 cycles then restart
+#    if children > 250 then restart
+#    if loadavg(5min) greater than 10 for 8 cycles then stop
+#    if failed host www.tildeslash.com port 80 protocol http 
+#       and request "/somefile.html"
+#       then restart
+#    if failed port 443 type tcpssl protocol http
+#       with timeout 15 seconds
+#       then restart
+#    if 3 restarts within 5 cycles then timeout
+#    depends on apache_bin
+#    group server
+#    
+#    
+## Check filesystem permissions, uid, gid, space and inode usage. Other services,
+## such as databases, may depend on this resource and an automatically graceful
+## stop may be cascaded to them before the filesystem will become full and data
+## lost.
+#
+#  check filesystem datafs with path /dev/sdb1
+#    start program  = "/bin/mount /data"
+#    stop program  = "/bin/umount /data"
+#    if failed permission 660 then unmonitor
+#    if failed uid root then unmonitor
+#    if failed gid disk then unmonitor
+#    if space usage > 80% for 5 times within 15 cycles then alert
+#    if space usage > 99% then stop
+#    if inode usage > 30000 then alert
+#    if inode usage > 99% then stop
+#    group server
+#
+#
+## Check a file's timestamp. In this example, we test if a file is older 
+## than 15 minutes and assume something is wrong if its not updated. Also,
+## if the file size exceed a given limit, execute a script
+#
+#  check file database with path /data/mydatabase.db
+#    if failed permission 700 then alert
+#    if failed uid data then alert
+#    if failed gid data then alert
+#    if timestamp > 15 minutes then alert
+#    if size > 100 MB then exec "/my/cleanup/script" as uid dba and gid dba
+#
+#
+## Check directory permission, uid and gid.  An event is triggered if the 
+## directory does not belong to the user with uid 0 and gid 0.  In addition, 
+## the permissions have to match the octal description of 755 (see chmod(1)).
+#
+#  check directory bin with path /bin
+#    if failed permission 755 then unmonitor
+#    if failed uid 0 then unmonitor
+#    if failed gid 0 then unmonitor
+#
+#
+## Check a remote host availability by issuing a ping test and check the 
+## content of a response from a web server. Up to three pings are sent and 
+## connection to a port and an application level network check is performed.
+#
+#  check host myserver with address 192.168.1.1
+#    if failed icmp type echo count 3 with timeout 3 seconds then alert
+#    if failed port 3306 protocol mysql with timeout 15 seconds then alert
+#    if failed url http://user:password@www.foo.bar:8080/?querystring
+#       and content == 'action="j_security_check"'
+#       then alert
+#
+#
+###############################################################################
+## Includes
+###############################################################################
+##
+## It is possible to include additional configuration parts from other files or
+## directories.
+#
+   include /etc/monit/conf.d/*
+#

deployment/puppet/monit/templates/process.erb

@@ -0,0 +1,3 @@
+check process <%= @name %> with pidfile <%= @pidfile %>
+  start program = "<%= @start_command %>" with timeout 60 seconds
+  stop program  = "<%= @stop_command %>"