puppet-retrospec 0.7.0 → 0.7.2

data/vendor/gems/puppet-3.7.3/lib/puppet/application/man.rb

@@ -0,0 +1,4 @@
+require 'puppet/application/face_base'
+
+class Puppet::Application::Man < Puppet::Application::FaceBase
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/master.rb

@@ -0,0 +1,304 @@
+require 'puppet/application'
+require 'puppet/daemon'
+require 'puppet/util/pidlock'
+
+class Puppet::Application::Master < Puppet::Application
+
+  run_mode :master
+
+  option("--debug", "-d")
+  option("--verbose", "-v")
+
+  # internal option, only to be used by ext/rack/config.ru
+  option("--rack")
+
+  option("--compile host",  "-c host") do |arg|
+    options[:node] = arg
+  end
+
+  option("--logdest DEST",  "-l DEST") do |arg|
+    handle_logdest_arg(arg)
+  end
+
+  option("--parseonly") do |args|
+    puts "--parseonly has been removed. Please use 'puppet parser validate <manifest>'"
+    exit 1
+  end
+
+  def help
+    <<-'HELP'
+
+puppet-master(8) -- The puppet master daemon
+========
+
+SYNOPSIS
+--------
+The central puppet server. Functions as a certificate authority by
+default.
+
+
+USAGE
+-----
+puppet master [-D|--daemonize|--no-daemonize] [-d|--debug] [-h|--help]
+  [-l|--logdest syslog|<FILE>|console] [-v|--verbose] [-V|--version]
+  [--compile <NODE-NAME>]
+
+
+DESCRIPTION
+-----------
+This command starts an instance of puppet master, running as a daemon
+and using Ruby's built-in Webrick webserver. Puppet master can also be
+managed by other application servers; when this is the case, this
+executable is not used.
+
+
+OPTIONS
+-------
+
+Note that any Puppet setting that's valid in the configuration file is also a
+valid long argument. For example, 'server' is a valid setting, so you can
+specify '--server <servername>' as an argument. Boolean settings translate into
+'--setting' and '--no-setting' pairs.
+
+See the configuration file documentation at
+http://docs.puppetlabs.com/references/stable/configuration.html for the
+full list of acceptable settings. A commented list of all settings can also be
+generated by running puppet master with '--genconfig'.
+
+* --daemonize:
+  Send the process into the background. This is the default.
+  (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-'
+  prefix for boolean settings on the command line.)
+
+* --no-daemonize:
+  Do not send the process into the background.
+  (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-'
+  prefix for boolean settings on the command line.)
+
+* --debug:
+  Enable full debugging.
+
+* --help:
+  Print this help message.
+
+* --logdest:
+  Where to send log messages. Choose between 'syslog' (the POSIX syslog
+  service), 'console', or the path to a log file. If debugging or verbosity is
+  enabled, this defaults to 'console'. Otherwise, it defaults to 'syslog'.
+
+* --masterport:
+  The port on which to listen for traffic.
+  (This is a Puppet setting, and can go in puppet.conf.)
+
+* --verbose:
+  Enable verbosity.
+
+* --version:
+  Print the puppet version number and exit.
+
+* --compile:
+  Compile a catalogue and output it in JSON from the puppet master. Uses
+  facts contained in the $vardir/yaml/ directory to compile the catalog.
+
+
+EXAMPLE
+-------
+  puppet master
+
+DIAGNOSTICS
+-----------
+
+When running as a standalone daemon, puppet master accepts the
+following signals:
+
+* SIGHUP:
+  Restart the puppet master server.
+* SIGINT and SIGTERM:
+  Shut down the puppet master server.
+* SIGUSR2:
+  Close file descriptors for log files and reopen them. Used with logrotate.
+
+AUTHOR
+------
+Luke Kanies
+
+
+COPYRIGHT
+---------
+Copyright (c) 2012 Puppet Labs, LLC Licensed under the Apache 2.0 License
+
+    HELP
+  end
+
+  # Sets up the 'node_cache_terminus' default to use the Write Only Yaml terminus :write_only_yaml.
+  # If this is not wanted, the setting ´node_cache_terminus´ should be set to nil.
+  # @see Puppet::Node::WriteOnlyYaml
+  # @see #setup_node_cache
+  # @see puppet issue 16753
+  #
+  def app_defaults
+    super.merge({
+      :node_cache_terminus => :write_only_yaml,
+      :facts_terminus => 'yaml'
+    })
+  end
+
+  def preinit
+    Signal.trap(:INT) do
+      $stderr.puts "Canceling startup"
+      exit(0)
+    end
+
+    # save ARGV to protect us from it being smashed later by something
+    @argv = ARGV.dup
+  end
+
+  def run_command
+    if options[:node]
+      compile
+    else
+      main
+    end
+  end
+
+  def compile
+    begin
+      unless catalog = Puppet::Resource::Catalog.indirection.find(options[:node])
+        raise "Could not compile catalog for #{options[:node]}"
+      end
+
+      puts PSON::pretty_generate(catalog.to_resource, :allow_nan => true, :max_nesting => false)
+    rescue => detail
+      Puppet.log_exception(detail, "Failed to compile catalog for node #{options[:node]}: #{detail}")
+      exit(30)
+    end
+    exit(0)
+  end
+
+  def main
+    require 'etc'
+    # Make sure we've got a localhost ssl cert
+    Puppet::SSL::Host.localhost
+
+    # And now configure our server to *only* hit the CA for data, because that's
+    # all it will have write access to.
+    Puppet::SSL::Host.ca_location = :only if Puppet::SSL::CertificateAuthority.ca?
+
+    if Puppet.features.root?
+      begin
+        Puppet::Util.chuser
+      rescue => detail
+        Puppet.log_exception(detail, "Could not change user to #{Puppet[:user]}: #{detail}")
+        exit(39)
+      end
+    end
+
+    if options[:rack]
+      start_rack_master
+    else
+      start_webrick_master
+    end
+  end
+
+  def setup_logs
+    set_log_level
+
+    if !options[:setdest]
+      if options[:node]
+        # We are compiling a catalog for a single node with '--compile' and logging
+        # has not already been configured via '--logdest' so log to the console.
+        Puppet::Util::Log.newdestination(:console)
+      elsif !(Puppet[:daemonize] or options[:rack])
+        # We are running a webrick master which has been explicitly foregrounded
+        # and '--logdest' has not been passed, assume users want to see logging
+        # and log to the console.
+        Puppet::Util::Log.newdestination(:console)
+      else
+        # No explicit log destination has been given with '--logdest' and we're
+        # either a daemonized webrick master or running under rack, log to syslog.
+        Puppet::Util::Log.newdestination(:syslog)
+      end
+    end
+  end
+
+  def setup_terminuses
+    require 'puppet/file_serving/content'
+    require 'puppet/file_serving/metadata'
+
+    Puppet::FileServing::Content.indirection.terminus_class = :file_server
+    Puppet::FileServing::Metadata.indirection.terminus_class = :file_server
+
+    Puppet::FileBucket::File.indirection.terminus_class = :file
+  end
+
+  def setup_ssl
+    # Configure all of the SSL stuff.
+    if Puppet::SSL::CertificateAuthority.ca?
+      Puppet::SSL::Host.ca_location = :local
+      Puppet.settings.use :ca
+      Puppet::SSL::CertificateAuthority.instance
+    else
+      Puppet::SSL::Host.ca_location = :none
+    end
+  end
+
+  # Sets up a special node cache "write only yaml" that collects and stores node data in yaml
+  # but never finds or reads anything (this since a real cache causes stale data to be served
+  # in circumstances when the cache can not be cleared).
+  # @see puppet issue 16753
+  # @see Puppet::Node::WriteOnlyYaml
+  # @return [void]
+  def setup_node_cache
+    Puppet::Node.indirection.cache_class = Puppet[:node_cache_terminus]
+  end
+
+  def setup
+    raise Puppet::Error.new("Puppet master is not supported on Microsoft Windows") if Puppet.features.microsoft_windows?
+
+    setup_logs
+
+    exit(Puppet.settings.print_configs ? 0 : 1) if Puppet.settings.print_configs?
+
+    Puppet.settings.use :main, :master, :ssl, :metrics
+
+    setup_terminuses
+
+    setup_node_cache
+
+    setup_ssl
+  end
+
+  private
+
+  # Start a master that will be using WeBrick.
+  #
+  # This method will block until the master exits.
+  def start_webrick_master
+    require 'puppet/network/server'
+    daemon = Puppet::Daemon.new(Puppet::Util::Pidlock.new(Puppet[:pidfile]))
+
+    daemon.argv = @argv
+    daemon.server = Puppet::Network::Server.new(Puppet[:bindaddress], Puppet[:masterport])
+    daemon.daemonize if Puppet[:daemonize]
+
+    announce_start_of_master
+
+    daemon.start
+  end
+
+  # Start a master that will be used for a Rack container.
+  #
+  # This method immediately returns the Rack handler that must be returned to
+  # the calling Rack container
+  def start_rack_master
+    require 'puppet/network/http/rack'
+
+    announce_start_of_master
+
+    return Puppet::Network::HTTP::Rack.new()
+  end
+
+  def announce_start_of_master
+    Puppet.notice "Starting Puppet master version #{Puppet.version}"
+  end
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/module.rb

@@ -0,0 +1,4 @@
+require 'puppet/application/face_base'
+
+class Puppet::Application::Module < Puppet::Application::FaceBase
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/node.rb

@@ -0,0 +1,4 @@
+require 'puppet/application/indirection_base'
+
+class Puppet::Application::Node < Puppet::Application::IndirectionBase
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/parser.rb

@@ -0,0 +1,5 @@
+require 'puppet/application/face_base'
+require 'puppet/face'
+
+class Puppet::Application::Parser < Puppet::Application::FaceBase
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/plugin.rb

@@ -0,0 +1,3 @@
+require 'puppet/application/face_base'
+class Puppet::Application::Plugin < Puppet::Application::FaceBase
+end

data/vendor/gems/puppet-3.7.3/lib/puppet/application/queue.rb

@@ -0,0 +1,161 @@
+require 'puppet/application'
+require 'puppet/util'
+require 'puppet/daemon'
+require 'puppet/util/pidlock'
+
+class Puppet::Application::Queue < Puppet::Application
+
+  attr_accessor :daemon
+
+  def app_defaults()
+    super.merge( :pidfile => "$rundir/queue.pid" )
+  end
+
+  def preinit
+    @argv = ARGV.dup
+
+    # Do an initial trap, so that cancels don't get a stack trace.
+
+    # This exits with exit code 1
+    Signal.trap(:INT) do
+      $stderr.puts "Caught SIGINT; shutting down"
+      exit(1)
+    end
+
+    # This is a normal shutdown, so code 0
+    Signal.trap(:TERM) do
+      $stderr.puts "Caught SIGTERM; shutting down"
+      exit(0)
+    end
+
+    {
+      :verbose => false,
+      :debug => false
+    }.each do |opt,val|
+      options[opt] = val
+    end
+  end
+
+  option("--debug","-d")
+  option("--verbose","-v")
+
+  def help
+    <<-HELP
+
+puppet-queue(8) -- Deprecated queuing daemon for asynchronous storeconfigs
+========
+
+SYNOPSIS
+--------
+Retrieves serialized storeconfigs records from a queue and processes
+them in order. THIS FEATURE IS DEPRECATED; use PuppetDB instead.
+
+
+USAGE
+-----
+puppet queue [-d|--debug] [--help] [-v|--verbose] [--version]
+
+
+DESCRIPTION
+-----------
+This application runs as a daemon and processes storeconfigs data,
+retrieving the data from a stomp server message queue and writing it to
+a database. It was once necessary as a workaround for the poor performance
+of ActiveRecord-based storeconfigs, but has been supplanted by the PuppetDB
+service, which gives better performance with less complexity.
+
+For more information, see the PuppetDB documentation at
+http://docs.puppetlabs.com/puppetdb/latest
+
+
+OPTIONS
+-------
+Note that any setting that's valid in the configuration
+file is also a valid long argument. For example, 'server' is a valid
+setting, so you can specify '--server <servername>' as
+an argument.
+
+See the configuration file documentation at
+http://docs.puppetlabs.com/references/stable/configuration.html for the
+full list of acceptable parameters. A commented list of all
+configuration options can also be generated by running puppet queue with
+'--genconfig'.
+
+* --debug:
+  Enable full debugging.
+
+* --help:
+  Print this help message
+
+* --verbose:
+  Turn on verbose reporting.
+
+* --version:
+  Print the puppet version number and exit.
+
+
+EXAMPLE
+-------
+    $ puppet queue
+
+
+AUTHOR
+------
+Luke Kanies
+
+
+COPYRIGHT
+---------
+Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License
+
+    HELP
+  end
+
+  option("--logdest DEST", "-l DEST") do |arg|
+    handle_logdest_arg(arg)
+  end
+
+  def main
+    require 'puppet/indirector/catalog/queue' # provides Puppet::Indirector::Queue.subscribe
+    Puppet.notice "Starting puppet queue #{Puppet.version}"
+    Puppet::Resource::Catalog::Queue.subscribe do |catalog|
+      # Once you have a Puppet::Resource::Catalog instance, passing it to save should suffice
+      # to put it through to the database via its active_record indirector (which is determined
+      # by the terminus_class = :active_record setting above)
+      Puppet::Util.benchmark(:notice, "Processing queued catalog for #{catalog.name}") do
+        begin
+          Puppet::Resource::Catalog.indirection.save(catalog)
+        rescue => detail
+          Puppet.log_exception(detail, "Could not save queued catalog for #{catalog.name}: #{detail}")
+        end
+      end
+    end
+
+    Thread.list.each { |thread| thread.join }
+  end
+
+  def setup
+    Puppet.warning "Puppet queue is deprecated. See http://links.puppetlabs.com/puppet-queue-deprecation"
+
+    unless Puppet.features.stomp?
+      raise ArgumentError, "Could not load the 'stomp' library, which must be present for queueing to work.  You must install the required library."
+    end
+
+    setup_logs
+
+    exit(Puppet.settings.print_configs ? 0 : 1) if Puppet.settings.print_configs?
+
+    require 'puppet/resource/catalog'
+    Puppet::Resource::Catalog.indirection.terminus_class = :store_configs
+
+    daemon = Puppet::Daemon.new(Puppet::Util::Pidlock.new(Puppet[:pidfile]))
+    daemon.argv = @argv
+    daemon.daemonize if Puppet[:daemonize]
+
+    # We want to make sure that we don't have a cache
+    # class set up, because if storeconfigs is enabled,
+    # we'll get a loop of continually caching the catalog
+    # for storage again.
+    Puppet::Resource::Catalog.indirection.cache_class = nil
+  end
+end