puppet-retrospec 0.12.2 → 1.0.0

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

@@ -0,0 +1,321 @@
+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
+https://docs.puppetlabs.com/puppet/latest/reference/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'.
+
+  A path ending with '.json' will receive structured output in JSON format. The
+  log file will not have an ending ']' automatically written to it due to the
+  appending nature of logging. It must be appended manually to make the content
+  valid JSON.
+
+* --masterport:
+  The port on which to listen for traffic. The default port is 8140.
+  (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?
+      if Puppet::Type.type(:user).new(:name => Puppet[:user]).exists?
+        begin
+          Puppet::Util.chuser
+        rescue => detail
+          Puppet.log_exception(detail, "Could not change user to #{Puppet[:user]}: #{detail}")
+          exit(39)
+        end
+      else
+        Puppet.err("Could not change user to #{Puppet[:user]}. User does not exist and is required to continue.")
+        exit(74)
+      end
+    end
+
+    if options[:rack]
+      Puppet.deprecation_warning("The Rack Puppet master server is deprecated and will be removed in a future release. Please use Puppet Server instead. See http://links.puppetlabs.com/deprecate-rack-webrick-servers for more information.")
+      start_rack_master
+    else
+      Puppet.deprecation_warning("The WEBrick Puppet master server is deprecated and will be removed in a future release. Please use Puppet Server instead. See http://links.puppetlabs.com/deprecate-rack-webrick-servers for more information.")
+      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
+    Puppet::SSL::Oids.register_puppet_oids
+    Puppet::SSL::Oids.load_custom_oid_file(Puppet[:trusted_oid_mapping_file])
+  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]
+
+    # Setup signal traps immediately after daemonization so we clean up the daemon
+    daemon.set_signal_traps
+
+    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-4.5.2/lib/puppet/application/resource.rb

@@ -0,0 +1,224 @@
+require 'puppet/application'
+
+class Puppet::Application::Resource < Puppet::Application
+
+  attr_accessor :host, :extra_params
+
+  def preinit
+    @extra_params = []
+  end
+
+  option("--debug","-d")
+  option("--verbose","-v")
+  option("--edit","-e")
+  option("--to_yaml","-y")
+
+  option("--types", "-t") do |arg|
+    types = []
+    Puppet::Type.loadall
+    Puppet::Type.eachtype do |t|
+      next if t.name == :component
+      types << t.name.to_s
+    end
+    puts types.sort
+    exit
+  end
+
+  option("--param PARAM", "-p") do |arg|
+    @extra_params << arg.to_sym
+  end
+
+  def help
+    <<-'HELP'
+
+puppet-resource(8) -- The resource abstraction layer shell
+========
+
+SYNOPSIS
+--------
+Uses the Puppet RAL to directly interact with the system.
+
+
+USAGE
+-----
+puppet resource [-h|--help] [-d|--debug] [-v|--verbose] [-e|--edit]
+  [-p|--param <parameter>] [-t|--types] [-y|--to_yaml] <type>
+  [<name>] [<attribute>=<value> ...]
+
+
+DESCRIPTION
+-----------
+This command provides simple facilities for converting current system
+state into Puppet code, along with some ability to modify the current
+state using Puppet's RAL.
+
+By default, you must at least provide a type to list, in which case
+puppet resource will tell you everything it knows about all resources of
+that type. You can optionally specify an instance name, and puppet
+resource will only describe that single instance.
+
+If given a type, a name, and a series of <attribute>=<value> pairs,
+puppet resource will modify the state of the specified resource.
+Alternately, if given a type, a name, and the '--edit' flag, puppet
+resource will write its output to a file, open that file in an editor,
+and then apply the saved file as a Puppet transaction.
+
+
+OPTIONS
+-------
+Note that any setting that's valid in the configuration
+file is also a valid long argument. For example, 'ssldir' is a valid
+setting, so you can specify '--ssldir <directory>' as an
+argument.
+
+See the configuration file documentation at
+https://docs.puppetlabs.com/puppet/latest/reference/configuration.html for the
+full list of acceptable parameters. A commented list of all
+configuration options can also be generated by running puppet with
+'--genconfig'.
+
+* --debug:
+  Enable full debugging.
+
+* --edit:
+  Write the results of the query to a file, open the file in an editor,
+  and read the file back in as an executable Puppet manifest.
+
+* --help:
+  Print this help message.
+
+* --param:
+  Add more parameters to be outputted from queries.
+
+* --types:
+  List all available types.
+
+* --verbose:
+  Print extra information.
+
+* --to_yaml:
+  Output found resources in yaml format, suitable to use with Hiera and create_resources.
+
+EXAMPLE
+-------
+This example uses `puppet resource` to return a Puppet configuration for
+the user `luke`:
+
+    $ puppet resource user luke
+    user { 'luke':
+     home => '/home/luke',
+     uid => '100',
+     ensure => 'present',
+     comment => 'Luke Kanies,,,',
+     gid => '1000',
+     shell => '/bin/bash',
+     groups => ['sysadmin','audio','video','puppet']
+    }
+
+
+AUTHOR
+------
+Luke Kanies
+
+
+COPYRIGHT
+---------
+Copyright (c) 2011 Puppet Labs, LLC Licensed under the Apache 2.0 License
+
+    HELP
+  end
+
+  def main
+    type, name, params = parse_args(command_line.args)
+
+    raise "Editing with Yaml output is not supported" if options[:edit] and options[:to_yaml]
+
+    resources = find_or_save_resources(type, name, params)
+
+    if options[:to_yaml]
+      text = resources.
+        map { |resource| resource.prune_parameters(:parameters_to_include => @extra_params).to_hierayaml }.
+        join("\n")
+      text.prepend("#{type.downcase}:\n")
+    else
+      text = resources.
+        map { |resource| resource.prune_parameters(:parameters_to_include => @extra_params).to_manifest }.
+        join("\n")
+    end
+
+    options[:edit] ?
+      handle_editing(text) :
+      (puts text)
+  end
+
+  def setup
+    Puppet::Util::Log.newdestination(:console)
+    set_log_level
+  end
+
+  private
+
+  def local_key(type, name)
+    [type, name].join('/')
+  end
+
+  def handle_editing(text)
+    require 'tempfile'
+    # Prefer the current directory, which is more likely to be secure
+    # and, in the case of interactive use, accessible to the user.
+    tmpfile = Tempfile.new('x2puppet', Dir.pwd)
+    begin
+      # sync write, so nothing buffers before we invoke the editor.
+      tmpfile.sync = true
+      tmpfile.puts text
+
+      # edit the content
+      system(ENV["EDITOR"] || 'vi', tmpfile.path)
+
+      # ...and, now, pass that file to puppet to apply.  Because
+      # many editors rename or replace the original file we need to
+      # feed the pathname, not the file content itself, to puppet.
+      system('puppet apply -v ' + tmpfile.path)
+    ensure
+      # The temporary file will be safely removed.
+      tmpfile.close(true)
+    end
+  end
+
+  def parse_args(args)
+    type = args.shift or raise "You must specify the type to display"
+    Puppet::Type.type(type) or raise "Could not find type #{type}"
+    name = args.shift
+    params = {}
+    args.each do |setting|
+      if setting =~ /^(\w+)=(.+)$/
+        params[$1] = $2
+      else
+        raise "Invalid parameter setting #{setting}"
+      end
+    end
+
+    [type, name, params]
+  end
+
+  def find_or_save_resources(type, name, params)
+    key = local_key(type, name)
+
+    if name
+      if params.empty?
+        [ Puppet::Resource.indirection.find( key ) ]
+      else
+        resource = Puppet::Resource.new( type, name, :parameters => params )
+
+        # save returns [resource that was saved, transaction log from applying the resource]
+        save_result = Puppet::Resource.indirection.save(resource, key)
+        [ save_result.first ]
+      end
+    else
+      if type == "file"
+        raise "Listing all file instances is not supported.  Please specify a file or directory, e.g. puppet resource file /etc"
+      end
+      Puppet::Resource.indirection.search( key, {} )
+    end
+  end
+end