openvox 7.37.1

data/examples/hiera/README.md

@@ -0,0 +1,91 @@
+A working demo of Hiera with YAML and Puppet backends.
+======================================================
+
+This demo consists of:
+
+ * A NTP module that has defaults for pool.ntp.org servers
+ * A common data module where module users can create override data in pp files
+ * A YAML data source in etc/hieradb where users can override data in yaml files
+ * A couple of users modules that just notify the fact that they are being included
+ * In Hiera data files a key called _classes_ that decides what to include on a node
+
+Below various usage scenarios can be tested using this module.
+
+The examples below assume you have Hiera already installed and that you have
+hiera-puppet cloned from github and running these commands in _hiera-puppet/example_ as cwd.
+
+Module from forge with module defaults
+--------------------------------------
+
+ * Move the _modules/data_ directory to _modules/data.bak_ to avoid overrides
+   used further in the example
+ * Run puppet, creates _/etc/ntp.conf_ with ntp.org addresses
+ * The _hiera\_include()_ function includes just _users::common_
+
+<pre>
+$ mv modules/data modules/data.bak
+$ puppet apply --config etc/puppet.conf site.pp
+notice: /Stage[main]/Ntp::Config/File[/tmp/ntp.conf]/ensure: defined content as '{md5}7045121976147a932a66c7671939a9ad'
+notice: /Stage[main]/Users::Common/Notify[Adding users::common]/message: defined 'message' as 'Adding users::common'
+$ cat /tmp/ntp.conf
+server 1.pool.ntp.org
+server 2.pool.ntp.org
+</pre>
+
+Site wide override data in _data::common_
+-----------------------------------------
+
+ * Restore the _modules/data_ directory that has a class _data::common_ that declares site wide overrides
+ * The _hiera_include()_ function includes just _users::common_
+
+<pre>
+$ mv modules/data.bak modules/data
+$ puppet apply --config etc/puppet.conf site.pp
+notice: /Stage[main]/Ntp::Config/File[/tmp/ntp.conf]/content: content changed '{md5}7045121976147a932a66c7671939a9addc2' to '{md5}8f9039fe1989a278a0a8e1836acb8d23'
+notice: /Stage[main]/Users::Common/Notify[Adding users::common]/message: defined 'message' as 'Adding users::common'
+$ cat /tmp/ntp.conf
+server ntp1.example.com
+server ntp2.example.com
+</pre>
+
+Fact driven overrides for location=dc1
+--------------------------------------
+
+ * Set a fact location=dc1 that uses the YAML data in _etc/hieradb/dc1.yaml_ to override
+ * Show that machines in dc2 would use site-wide defaults
+ * The _hiera_include()_ function includes _users::common_ and _users::dc1_ as the data file for dc1 adds that
+
+<pre>
+$ FACTER_location=dc1 puppet apply --config etc/puppet.conf site.pp
+notice: /Stage[main]/Ntp::Config/File[/tmp/ntp.conf]/content: content changed '{md5}8f9039fe1989a278a0a8e1836acb8d23' to '{md5}074d0e2ac727f6cb9afe3345d574b578'
+notice: /Stage[main]/Users::Common/Notify[Adding users::common]/message: defined 'message' as 'Adding users::common'
+notice: /Stage[main]/Users::Dc1/Notify[Adding users::dc1]/message: defined 'message' as 'Adding users::dc1'
+$ cat /tmp/ntp.conf
+server ntp1.dc1.example.com
+server ntp2.dc1.example.com
+</pre>
+
+Now simulate a machine in _dc2_, because there is no data for dc2 it uses the site wide defaults and
+does not include the _users::dc1_ class anymore
+
+<pre>
+$ FACTER_location=dc2 puppet apply --config etc/puppet.conf site.pp
+warning: Could not find class data::dc2 for nephilim.ml.org
+notice: /Stage[main]/Ntp::Config/File[/tmp/ntp.conf]/content: content changed '{md5}074d0e2ac727f6cb9afe3345d574b578' to '{md5}8f9039fe1989a278a0a8e1836acb8d23'
+notice: /Stage[main]/Users::Common/Notify[Adding users::common]/message: defined 'message' as 'Adding users::common'
+$ cat /tmp/ntp.conf
+server ntp1.example.com
+server ntp2.example.com
+</pre>
+
+You could create override data in the following places for a machine in _location=dc2_, they will be searched in this order and the first one with data will match.
+
+ * file etc/hieradb/dc2.yaml
+ * file etc/hieradb/common.yaml
+ * class data::dc2
+ * class data::production
+ * class data::common
+ * class ntp::config::data
+ * class ntp::data
+
+In this example due to the presence of _common.yaml_ that declares _ntpservers_ the classes will never be searched, it will have precedence.

data/examples/hiera/etc/hiera.yaml

@@ -0,0 +1,15 @@
+---
+:backends:
+  - yaml
+  - puppet
+
+:hierarchy:
+  - "%{location}"
+  - "%{environment}"
+  - common
+
+:yaml:
+  :datadir: etc/hieradb
+
+:puppet:
+  :datasource: data

data/examples/hiera/etc/hieradb/common.yaml

@@ -0,0 +1,3 @@
+classes:
+  - users::common
+  - ntp::config

data/examples/hiera/etc/hieradb/dc1.yaml

@@ -0,0 +1,6 @@
+---
+ntpservers:
+  - ntp1.dc1.example.com
+  - ntp2.dc1.example.com
+classes:
+  - users::dc1

data/examples/hiera/etc/hieradb/development.yaml

@@ -0,0 +1,2 @@
+---
+classes: users::development

data/examples/hiera/etc/puppet.conf

@@ -0,0 +1,3 @@
+[main]
+  modulepath = modules
+

data/examples/hiera/modules/data/manifests/common.pp

@@ -0,0 +1,4 @@
+# sets the common (across all puppet conf) ntp servers.
+class data::common {
+  $ntpservers = ['ntp1.example.com', 'ntp2.example.com']
+}

data/examples/hiera/modules/ntp/manifests/config.pp

@@ -0,0 +1,6 @@
+# lookup ntpservers from hiera, or allow user of class to provide other value
+class ntp::config($ntpservers = hiera('ntpservers')) {
+  file{'/tmp/ntp.conf':
+    content => template('ntp/ntp.conf.erb')
+  }
+}

data/examples/hiera/modules/ntp/manifests/data.pp

@@ -0,0 +1,4 @@
+# this class will be loaded using hiera's 'puppet' backend
+class ntp::data {
+  $ntpservers = ['1.pool.ntp.org', '2.pool.ntp.org']
+}

data/examples/hiera/modules/ntp/templates/ntp.conf.erb

@@ -0,0 +1,3 @@
+<% [ntpservers].flatten.each do |server| -%>
+server <%= server %>
+<% end -%>

data/examples/hiera/modules/users/manifests/common.pp

@@ -0,0 +1,4 @@
+# notifies
+class users::common {
+  notify{'Adding users::common': }
+}

data/examples/hiera/modules/users/manifests/dc1.pp

@@ -0,0 +1,4 @@
+# notifies
+class users::dc1 {
+  notify{'Adding users::dc1': }
+}

data/examples/hiera/modules/users/manifests/development.pp

@@ -0,0 +1,4 @@
+# notifies
+class users::development {
+  notify{'Adding users::development': }
+}

data/examples/hiera/site.pp

@@ -0,0 +1,3 @@
+node default {
+  hiera_include('classes')
+}

data/examples/nagios/check_puppet.rb

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'sys/proctable'
+include Sys
+
+class CheckPuppet
+
+  VERSION = '0.1'
+  script_name = File.basename($0)
+
+  # default options
+  OPTIONS = {
+    :statefile => "/opt/puppetlabs/puppet/cache/state/state.yaml",
+    :process   => "puppet",
+    :interval  => 30,
+  }
+
+  OptionParser.new do |o|
+    o.set_summary_indent('  ')
+    o.banner =    "Usage: #{script_name} [OPTIONS]"
+    o.define_head "The check_puppet Nagios plug-in checks that specified Puppet process is running and the state file is no older than specified interval."
+      o.separator   ""
+      o.separator   "Mandatory arguments to long options are mandatory for short options too."
+
+
+        o.on(
+          "-s", "--statefile=statefile", String, "The state file",
+
+    "Default: #{OPTIONS[:statefile]}") { |op| OPTIONS[:statefile] = op }
+
+      o.on(
+        "-p", "--process=processname", String, "The process to check",
+
+    "Default: #{OPTIONS[:process]}")   { |op| OPTIONS[:process] = op }
+
+      o.on(
+        "-i", "--interval=value", Integer,
+
+    "Default: #{OPTIONS[:interval]} minutes")  { |op| OPTIONS[:interval] = op }
+
+    o.separator ""
+    o.on_tail("-h", "--help", "Show this help message.") do
+      puts o
+      exit
+    end
+
+    o.parse!(ARGV)
+  end
+
+  def check_proc
+
+    unless ProcTable.ps.find { |p| p.name == OPTIONS[:process]}
+      @proc = 2
+    else
+      @proc = 0
+    end
+
+  end
+
+  def check_state
+
+    # Set variables
+    curt = Time.now
+    intv = OPTIONS[:interval] * 60
+
+    # Check file time
+    begin
+      @modt = File.mtime("#{OPTIONS[:statefile]}")
+    rescue
+      @file = 3
+    end
+
+    diff = (curt - @modt).to_i
+
+    if diff > intv
+      @file = 2
+    else
+      @file = 0
+    end
+
+  end
+
+  def output_status
+
+    case @file
+    when 0
+      state = "state file status okay updated on " + @modt.strftime("%m/%d/%Y at %H:%M:%S")
+    when 2
+      state = "state fille is not up to date and is older than #{OPTIONS[:interval]} minutes"
+    when 3
+      state = "state file status unknown"
+    end
+
+    case @proc
+    when 0
+      process = "process #{OPTIONS[:process]} is running"
+    when 2
+      process = "process #{OPTIONS[:process]} is not running"
+    end
+
+    case
+    when (@proc == 2 or @file == 2)
+      status = "CRITICAL"
+      exitcode = 2
+    when (@proc == 0 and @file == 0)
+      status = "OK"
+      exitcode = 0
+    else
+      status = "UNKNOWN"
+      exitcode = 3
+    end
+
+    puts "PUPPET #{status}: #{process}, #{state}"
+    exit(exitcode)
+  end
+end
+
+cp = CheckPuppet.new
+cp.check_proc
+cp.check_state
+cp.output_status
+

data/ext/README.md

@@ -0,0 +1,13 @@
+# `ext/` directory details 
+This directory contains files used internally when packaging [puppet](https://github.com/puppetlabs/puppet) and [puppet-agent](https://github.com/puppetlabs/puppet-agent)
+What follows is a more detailed description of each directory/file:
+* `debian/` - init scripts for puppet (used for Debian-based platforms that do not support systemd)
+* `hiera/hiera.yaml` - installed to `$codedir/environments/production`as a default Hiera configuration file
+* `osx/puppet.plist` - puppet launchd plist for macOS
+* `redhat/` -  init scripts for puppet (used for EL-based platforms that do not support systemd)
+* `solaris/smf/` - service manifests for Solaris 11
+* `suse/client.init` - init script for puppet (used for SUSE-based platforms that do not support systemd) 
+* `systemd/puppet.service` - systemd unit file for puppet
+* `windows/` - the puppet daemon for Windows, and other useful `.bat` helper wrappers
+* `build_defaults.yaml` - information pertaining to the puppetlabs build automation
+* `project_data.yaml` - information used when packaging the puppet gem

data/ext/build_defaults.yaml

@@ -0,0 +1,18 @@
+---
+packager: 'puppetlabs'
+
+# These are the build targets used by the packaging repo. Uncomment to allow use.
+#final_mocks: 'pl-el-5-i386 pl-el-6-i386 pl-el-7-x86_64'
+#cows: 'base-lucid-i386.cow base-precise-i386.cow base-squeeze-i386.cow base-trusty-i386.cow base-wheezy-i386.cow'
+pbuild_conf: '/etc/pbuilderrc'
+
+build_gem: TRUE
+build_dmg: FALSE
+sign_tar: FALSE
+yum_host: 'yum.puppetlabs.com'
+yum_repo_path: '/opt/repository/yum/'
+apt_signing_server: 'apt.puppetlabs.com'
+apt_repo_url: 'http://apt.puppetlabs.com'
+apt_repo_path: '/opt/repository/incoming'
+tar_host: 'downloads.puppetlabs.com'
+nonfinal_gem_path: '/opt/repository-nightlies/downloads/gems/puppet7-nightly'

data/ext/debian/puppet.default

@@ -0,0 +1,4 @@
+# Defaults for puppet - sourced by /etc/init.d/puppet
+
+# Startup options
+DAEMON_OPTS=""

data/ext/debian/puppet.init

@@ -0,0 +1,113 @@
+#! /bin/sh
+### BEGIN INIT INFO
+# Provides:          puppet
+# Required-Start:    $network $named $remote_fs $syslog
+# Required-Stop:     $network $named $remote_fs $syslog
+# Should-Start:      puppet
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 6
+### END INIT INFO
+
+DAEMON=/opt/puppetlabs/puppet/bin/puppet
+DAEMON_OPTS=""
+NAME="agent"
+PROCNAME="puppet"
+DESC="puppet agent"
+PIDFILE="/var/run/puppetlabs/${NAME}.pid"
+
+test -x $DAEMON || exit 0
+
+[ -r /etc/default/puppet ] && . /etc/default/puppet
+
+. /lib/lsb/init-functions
+
+reload_puppet_agent() {
+    start-stop-daemon --stop --quiet --signal HUP --pidfile $PIDFILE --name $PROCNAME
+}
+
+start_puppet_agent() {
+    start-stop-daemon --start --quiet --pidfile $PIDFILE --startas $DAEMON -- $NAME $DAEMON_OPTS
+}
+
+stop_puppet_agent() {
+    start-stop-daemon --stop --retry TERM/10/KILL/5 --quiet --oknodo --pidfile $PIDFILE --name $PROCNAME
+    rm -f "$PIDFILE"
+}
+
+restart_puppet_agent() {
+    log_begin_msg "Restarting $DESC"
+    stop_puppet_agent
+    start_puppet_agent
+    log_end_msg $?
+}
+
+status_puppet_agent() {
+    if (type status_of_proc > /dev/null 2>&1) ; then
+        status_of_proc -p "${PIDFILE}" "${DAEMON}" "${NAME}"
+    else
+        status_of_proc() {
+            local pidfile daemon name status
+
+            pidfile=
+            OPTIND=1
+            while getopts p: opt ; do
+                case "$opt" in
+                    p)  pidfile="$OPTARG";;
+                esac
+            done
+            shift $(($OPTIND - 1))
+
+            if [ -n "$pidfile" ]; then
+                pidfile="-p $pidfile"
+            fi
+            daemon="$1"
+            name="$2"
+            status="0"
+            pidofproc $pidfile $daemon >/dev/null || status="$?"
+            if [ "$status" = 0 ]; then
+                log_success_msg "$name is running"
+                return 0
+            elif [ "$status" = 4 ]; then
+                log_failure_msg "could not access PID file for $name"
+                return $status
+            else
+                log_failure_msg "$name is not running"
+                return $status
+            fi
+        }
+        status_of_proc -p "${PIDFILE}" "${DAEMON}" "${NAME}"
+    fi
+}
+
+case "$1" in
+    start)
+        log_begin_msg "Starting $DESC"
+        start_puppet_agent
+        log_end_msg $?
+    ;;
+    stop)
+        log_begin_msg "Stopping $DESC"
+        stop_puppet_agent
+        log_end_msg $?
+    ;;
+    reload)
+        log_begin_msg "Reloading $DESC"
+        reload_puppet_agent
+        log_end_msg $?
+    ;;
+    status)
+        status_puppet_agent
+    ;;
+    restart|force-reload)
+        restart_puppet_agent
+    ;;
+    condrestart)
+        if status_puppet_agent >/dev/null 2>&1; then
+            restart_puppet_agent
+        fi
+    ;;
+    *)
+        echo "Usage: $0 {start|stop|status|restart|condrestart|force-reload|reload}" >&2
+        exit 1
+    ;;
+esac

data/ext/hiera/hiera.yaml

@@ -0,0 +1,15 @@
+---
+version: 5
+defaults:
+  # The default value for "datadir" is "data" under the same directory as the hiera.yaml
+  # file (this file)
+  # When specifying a datadir, make sure the directory exists.
+  # See https://puppet.com/docs/puppet/latest/environments_about.html for further details on environments.
+  # datadir: data
+  # data_hash: yaml_data
+hierarchy:
+  - name: "Per-node data (yaml version)"
+    path: "nodes/%{::trusted.certname}.yaml"
+  - name: "Other YAML hierarchy levels"
+    paths:
+      - "common.yaml"

data/ext/osx/puppet.plist

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+        <key>EnvironmentVariables</key>
+        <dict>
+                <key>LANG</key>
+                <string>en_US.UTF-8</string>
+        </dict>
+        <key>Label</key>
+        <string>puppet</string>
+        <key>KeepAlive</key>
+        <true/>
+        <key>ProgramArguments</key>
+        <array>
+                <string>/opt/puppetlabs/bin/puppet</string>
+                <string>agent</string>
+                <string>--verbose</string>
+                <string>--no-daemonize</string>
+                <string>--logdest</string>
+                <string>console</string>
+        </array>
+        <key>RunAtLoad</key>
+        <true/>
+        <key>StandardErrorPath</key>
+        <string>/var/log/puppetlabs/puppet/puppet.log</string>
+        <key>StandardOutPath</key>
+        <string>/var/log/puppetlabs/puppet/puppet.log</string>
+        <key>SessionCreate</key>
+        <true />
+</dict>
+</plist>

data/ext/project_data.yaml

@@ -0,0 +1,20 @@
+---
+project: 'puppet'
+gem_rdoc_options:
+  - --title
+  - "Puppet - Configuration Management"
+  - --main
+  - README.md
+  - --line-numbers
+# Array of files to include when building source tarballs
+files:
+  - '[A-Z]*'
+  - install.rb
+  - bin
+  - lib
+  - conf
+  - man
+  - examples
+  - ext
+  - tasks
+  - locales