cfacter 3.11.0.rc.20180314

data/ext/facter/facter/MAINTAINERS

@@ -0,0 +1,28 @@
+{
+  "version": 1,
+  "file_format": "This MAINTAINERS file format is described at https://github.com/puppetlabs/maintainers",
+  "issues": "https://tickets.puppet.com/browse/FACT",
+  "internal_list": "https://groups.google.com/a/puppet.com/forum/?hl=en#!forum/discuss-facter-maintainers",
+  "people": [
+    {
+      "github": "magisus",
+      "email": "maggie@puppet.com",
+      "name": "Maggie Dreyer"
+    },
+    {
+      "github": "MikaelSmith",
+      "email": "michael.smith@puppet.com",
+      "name": "Michael Smith"
+    },
+    {
+      "github": "branan",
+      "email": "branan@puppet.com",
+      "name": "Branan Riley"
+    },
+    {
+      "github": "peterhuene",
+      "email": "peter.huene@puppet.com",
+      "name": "Peter Huene"
+    }
+  ]
+}

data/ext/facter/facter/README.md

@@ -0,0 +1,295 @@
+Native Facter
+=============
+
+An implementation of facter functionality in C++11, providing:
+
+* a shared library which gather facts about the system
+* an executable for standalone command line usage
+* a ruby file to enable `require 'facter'`.
+
+Please see our [extensibility document](Extensibility.md) to learn more
+about extending native facter using custom and external facts.
+
+Build Requirements
+------------------
+
+* GCC 4.8+ or Clang 5.0+ (OSX)
+* CMake >= 3.2.2
+* Boost C++ Libraries >= 1.54
+* yaml-cpp >= 0.5.1
+* [leatherman](https://github.com/puppetlabs/leatherman) >= 1.0.0
+* [cpp-hocon](https://github.com/puppetlabs/cpp-hocon) >= 0.1.0
+
+Optional Build Libraries
+------------------------
+
+* OpenSSL - enables SSH fingerprinting facts.
+* libblkid (Linux only) - enables the partitions fact.
+* libcurl >= 7.18.0 - enables facts that perform HTTP requests.
+
+Initial Setup
+-------------
+
+Note: Testing custom facts requires Ruby 1.9+ with libruby built as a dynamic library; that often implies development builds of Ruby.
+
+### Setup on Fedora 23
+
+The following will install all required tools and libraries:
+
+    dnf install boost-devel openssl-devel yaml-cpp-devel libblkid-devel libcurl-devel gcc-c++ make wget tar cmake
+
+### Setup on Mac OSX El Capitan (homebrew)
+
+This assumes Clang is installed and the system OpenSSL libraries will be used.
+
+The following will install all required libraries:
+
+    brew install cmake boost yaml-cpp
+
+### Setup on Ubuntu 15.10 (Trusty)
+
+The following will install most required tools and libraries:
+
+    apt-get install build-essential libboost-all-dev libssl-dev libyaml-cpp-dev libblkid-dev libcurl4-openssl-dev wget tar cmake
+
+### Setup on FreeBSD 10
+
+The following will install most required tools and libraries:
+
+    pkg install git ruby21 cmake boost-all yaml-cpp gcc49
+
+### Setup on Windows
+
+[MinGW-w64](http://mingw-w64.sourceforge.net/) is used for full C++11 support, and [Chocolatey](https://chocolatey.org) can be used to install. You should have at least 2GB of memory for compilation.
+
+* install [CMake](https://chocolatey.org/packages/cmake)
+* install [MinGW-w64](https://chocolatey.org/packages/mingw)
+
+        choco install mingw --params "/threads:win32"
+
+For the remaining tasks, build commands can be executed in the shell from Start > MinGW-w64 project > Run Terminal
+
+* select an install location for dependencies, such as C:\\tools or cmake\\release\\ext; we'll refer to it as $install
+
+* build [Boost](http://sourceforge.net/projects/boost/files/latest/download)
+
+        .\bootstrap mingw
+        .\b2 toolset=gcc --build-type=minimal install --prefix=$install --with-program_options --with-system --with-filesystem --with-date_time --with-thread --with-regex --with-log --with-locale --with-chrono boost.locale.iconv=off
+
+* build [yaml-cpp](https://github.com/jbeder/yaml-cpp)
+
+        cmake -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH=$install -DCMAKE_INSTALL_PREFIX=$install .
+        mingw32-make install
+
+* build [libcurl](http://curl.haxx.se/download)
+
+        mingw32-make mingw32
+        cp -r include\curl $install\include
+        cp -r lib\libcurl.a $install\lib
+
+In Powershell:
+
+    choco install cmake 7zip.commandline -y
+    $env:PATH = "C:\Program Files\CMake\bin;$env:PATH"
+    choco install mingw --params "/threads:win32" -y
+    $env:PATH = "C:\tools\mingw64\bin;$env:PATH"
+    $install = "C:\tools"
+
+    (New-Object Net.WebClient).DownloadFile("https://downloads.sourceforge.net/boost/boost_1_54_0.7z", "$pwd/boost_1_54_0.7z")
+    7za x boost_1_54_0.7z
+    pushd boost_1_54_0
+    .\bootstrap mingw
+    .\b2 toolset=gcc --build-type=minimal install --prefix=$install --with-program_options --with-system --with-filesystem --with-date_time --with-thread --with-regex --with-log --with-locale --with-chrono boost.locale.iconv=off
+    popd
+
+    (New-Object Net.WebClient).DownloadFile("https://github.com/jbeder/yaml-cpp/archive/yaml-cpp-0.5.3.tar.gz", "$pwd/yaml-cpp-0.5.3.tar.gz")
+    7za x yaml-cpp-0.5.3.tar.gz
+    7za x yaml-cpp-0.5.3.tar
+    pushd yaml-cpp-yaml-cpp-0.5.3
+    cmake -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH="$install" -DCMAKE_INSTALL_PREFIX="$install" .
+    mingw32-make install
+    popd
+
+    (New-Object Net.WebClient).DownloadFile("http://curl.haxx.se/download/curl-7.42.1.zip", "$pwd/curl-7.42.1.zip")
+    7za x curl-7.42.1.zip
+    pushd curl-7.42.1
+    mingw32-make mingw32
+    cp -r include\curl $install\include
+    cp -r lib\libcurl.a $install\lib
+    popd
+
+Note that OpenSSL isn't needed on Windows.
+
+### Setup on OpenBSD 6.0
+
+The following will install all required tools and libraries:
+
+	pkg_add boost cmake curl g++ ruby yaml-cpp
+
+Optionally `leatherman` can be installed from packages too if not
+built locally.
+
+### Build and install Leatherman and cpp-hocon
+
+[Leatherman](https://github.com/puppetlabs/leatherman) and [cpp-hocon](https://github.com/puppetlabs/cpp-hocon) are built similar to the Pre-Build instructions below. If building on Windows, install to the same `$install` location used for other dependencies.
+
+Pre-Build
+---------
+
+All of the following examples start by assuming the current directory is the root of the repo.
+
+On Windows, add `-G "MinGW Makefiles" -DCMAKE_PREFIX_PATH=\<binary install path\> -DBOOST_STATIC=ON` to the `cmake` invocation.
+
+Before building facter, use `cmake` to generate build files:
+
+    $ mkdir release
+    $ cd release
+    $ cmake ..
+
+To generate build files with debug information:
+
+    $ mkdir debug
+    $ cd debug
+    $ cmake -DCMAKE_BUILD_TYPE=Debug ..
+
+Build
+-----
+
+To build facter, use 'make':
+
+    $ cd release
+    $ make
+
+To build facter with debug information:
+
+    $ cd debug
+    $ make
+
+Run
+---
+
+You can run facter from where it was built:
+
+`$ release/bin/facter`
+
+For a debug build:
+
+`$ debug/bin/facter`
+
+Test
+----
+
+If a ruby was found during configuration, execute the following command before running tests:
+
+    $ bundle install --gemfile lib/Gemfile
+
+You can run facter tests using the test target:
+
+    $ cd release
+    $ make test
+
+For a debug build:
+
+    $ cd debug
+    $ make test
+
+For verbose test output, run `ctest` instead of using the test target:
+
+    $ cd release
+    $ ctest -V
+
+Install
+-------
+
+You can install facter into your system:
+
+    $ cd release
+    $ make && sudo make install
+
+By default, facter will install files into `/usr/local/bin`, `/usr/local/lib`, and `/usr/local/include`.
+If the project is configured with Ruby in the PATH, *facter.rb* will be installed to that Ruby's vendor dir.
+The install location for *facter.rb* can be overridden using by setting RUBY_LIB_INSTALL.
+
+To install to a different location, set the install prefix:
+
+    $ cd release
+    $ cmake -DCMAKE_INSTALL_PREFIX=~ ..
+    $ make clean install
+
+This would install facter into `~/bin`, `~/lib`, and `~/include`.
+
+Ruby Usage
+----------
+
+Using the Ruby API requires that facter.rb is installed into the Ruby load path, as done in the previous install steps.
+
+```ruby
+    require 'facter'
+
+    # Use the Facter API...
+    puts "kernel: #{Facter.value(:kernel)}"
+```
+
+Configuration
+-------------
+
+Facter can be configured via a HOCON config file of the following format:
+
+```
+global : {
+    external-dir     : [ "path1", "path2" ],
+    custom-dir       : [ "custom/path" ],
+    no-exernal-facts : false,
+    no-custom-facts  : false,
+    no-ruby          : false
+}
+cli : {
+    debug     : false,
+    trace     : true,
+    verbose   : false,
+    log-level : "warn"
+}
+facts : {
+    blocklist : [ "file system", "EC2" ]
+    ttls : [
+        { "timezone" : 30 days },
+    ]
+}
+```
+All options are respected when running Facter standalone, while calling Facter from Ruby will only load `external-dir`, `custom-dir`, and the fact-specific configuration.
+
+The file will be loaded by default from `/etc/puppetlabs/facter/facter.conf` on Unix and `C:\ProgramData\PuppetLabs\facter\etc\facter.conf` on Windows. A different location can be specified using the `--config` command line option.
+
+Elements in the blocklist are fact groupings which will not be resolved when Facter runs. Use the `--list-block-group` command line option to see valid blockable groups.
+
+Elements in the ttls section are key-value pairs of fact groupings that will be cached with the duration for which to cache them. Cached facts are stored as JSON in `/opt/puppetlabs/facter/cache/cached_facts` on Unix and `C:\ProgramData\PuppetLabs\facter\cache\cached_facts` on Windows. Use the `--list-cache-groups` command line option to see valid cacheable groups.
+
+Uninstall
+---------
+
+Run the following command to remove files that were previously installed:
+
+    $ sudo xargs rm < release/install_manifest.txt
+
+Documentation
+-------------
+
+To generate API documentation, install doxygen 1.8.7 or later.
+
+    $ cd lib
+    $ doxygen
+
+To view the documentation, open `lib/html/index.html` in a web browser.
+
+Debugging
+---------
+
+If when running the tests you encounter this error message:
+
+"could not locate a ruby library"
+
+You may need to use a different shared ruby library in Leatherman. To do
+this, run this command, where the location below is the default for a
+puppet agent installation:
+
+    $ export LEATHERMAN_RUBY=/opt/puppetlabs/puppet/lib/libruby.dylib

data/ext/facter/facter/Rakefile

@@ -0,0 +1,42 @@
+RAKE_ROOT = File.expand_path(File.dirname(__FILE__))
+
+$LOAD_PATH << File.join(RAKE_ROOT, 'tasks')
+require 'rake'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+build_defs_file = File.join(RAKE_ROOT, 'ext', 'build_defaults.yaml')
+if File.exist?(build_defs_file)
+  begin
+    require 'yaml'
+    @build_defaults ||= YAML.load_file(build_defs_file)
+  rescue Exception => e
+    STDERR.puts "Unable to load yaml from #{build_defs_file}:"
+    raise e
+  end
+  @packaging_url  = @build_defaults['packaging_url']
+  @packaging_repo = @build_defaults['packaging_repo']
+  raise "Could not find packaging url in #{build_defs_file}" if @packaging_url.nil?
+  raise "Could not find packaging repo in #{build_defs_file}" if @packaging_repo.nil?
+
+  namespace :package do
+    desc "Bootstrap packaging automation, e.g. clone into packaging repo"
+    task :bootstrap do
+      if File.exist?(File.join(RAKE_ROOT, "ext", @packaging_repo))
+        puts "It looks like you already have ext/#{@packaging_repo}. If you don't like it, blow it away with package:implode."
+      else
+        cd File.join(RAKE_ROOT, 'ext') do
+          %x{git clone #{@packaging_url}}
+        end
+      end
+    end
+    desc "Remove all cloned packaging automation"
+    task :implode do
+      rm_rf File.join(RAKE_ROOT, "ext", @packaging_repo)
+    end
+  end
+end
+
+begin
+  load File.join(RAKE_ROOT, 'ext', 'packaging', 'packaging.rake')
+rescue LoadError
+end

data/ext/facter/facter/acceptance/Gemfile

@@ -0,0 +1,21 @@
+source ENV['GEM_SOURCE'] || "https://rubygems.org"
+
+def location_for(place, fake_version = nil)
+  if place =~ /^(git:[^#]*)#(.*)/
+    [fake_version, { :git => $1, :branch => $2, :require => false }].compact
+  elsif place =~ /^file:\/\/(.*)/
+    ['>= 0', { :path => File.expand_path($1), :require => false }]
+  else
+    [place, { :require => false }]
+  end
+end
+
+gem "beaker", *location_for(ENV['BEAKER_VERSION'] || "~> 3.10")
+gem "beaker-hostgenerator", *location_for(ENV['BEAKER_HOSTGENERATOR_VERSION'] || "~> 0.3")
+gem "beaker-abs", *location_for(ENV['BEAKER_ABS_VERSION'] || "~> 0.2")
+gem 'rake', "~> 10.1.0"
+gem "multi_json", "~> 1.8"
+
+if File.exists? "#{__FILE__}.local"
+  eval(File.read("#{__FILE__}.local"), binding)
+end

data/ext/facter/facter/acceptance/Rakefile

@@ -0,0 +1,342 @@
+require 'rake/clean'
+require 'pp'
+require 'yaml'
+require 'securerandom'
+require 'fileutils'
+require 'beaker-hostgenerator'
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), 'lib'))
+require 'puppet/acceptance/git_utils'
+extend Puppet::Acceptance::GitUtils
+
+ONE_DAY_IN_SECS = 24 * 60 * 60
+REPO_CONFIGS_DIR = "repo-configs"
+CLEAN.include('*.tar', REPO_CONFIGS_DIR, 'merged_options.rb')
+
+module HarnessOptions
+
+  DEFAULTS = {
+    :type => 'git',
+    :helper => ['lib/helper.rb'],
+    :tests  => ['tests'],
+    :log_level => 'debug',
+    :color => false,
+    :root_keys => true,
+    :ssh => {
+      :keys => ["~/.ssh/id_rsa-acceptance"],
+    },
+    :xml => true,
+    :timesync => false,
+    :repo_proxy => true,
+    :add_el_extras => false,
+    :preserve_hosts => 'onfail',
+  }
+
+  class Aggregator
+    attr_reader :mode
+
+    def initialize(mode)
+      @mode = mode
+    end
+
+    def get_options(file_path)
+      puts file_path
+      if File.exists? file_path
+        options = eval(File.read(file_path), binding)
+      else
+        puts "No options file found at #{File.expand_path(file_path)}"
+      end
+      options || {}
+    end
+
+    def get_mode_options
+      get_options("./config/#{mode}/options.rb")
+    end
+
+    def get_local_options
+      get_options("./local_options.rb")
+    end
+
+    def final_options(intermediary_options = {})
+      mode_options = get_mode_options
+      local_overrides = get_local_options
+      final_options = DEFAULTS.merge(mode_options)
+      final_options.merge!(intermediary_options)
+      final_options.merge!(local_overrides)
+      return final_options
+    end
+  end
+
+  def self.options(mode, options)
+    final_options = Aggregator.new(mode).final_options(options)
+    final_options
+  end
+end
+
+def beaker_test(mode = :aio, options = {})
+  final_options = HarnessOptions.options(mode, options)
+
+  if mode == :git
+    final_options[:install] ||= []
+    final_options[:install] << "#{build_giturl('facter')}##{sha}"
+  end
+
+  options_file = 'merged_options.rb'
+  File.open(options_file, 'w') do |merged|
+    merged.puts <<-EOS
+# Copy this file to local_options.rb and adjust as needed if you wish to run
+# with some local overrides.
+EOS
+    merged.puts(final_options.pretty_inspect)
+  end
+
+  tests = ENV['TESTS'] || ENV['TEST']
+  tests_opt = "--tests=#{tests}" if tests
+
+  target = ENV['TEST_TARGET']
+  if config and File.exists?(config)
+    config_opt = "--hosts=#{config}"
+  elsif target
+    cli = BeakerHostGenerator::CLI.new([target, '--disable-default-role', '--osinfo-version', '1'])
+    ENV['BEAKER_HOSTS'] = "tmp/#{target}-#{SecureRandom.uuid}.yaml"
+    FileUtils.mkdir_p('tmp')
+    File.open(config, 'w') do |fh|
+      fh.print(cli.execute)
+    end
+    config_opt = "--hosts=#{config}"
+  end
+
+  overriding_options = ENV['OPTIONS']
+
+  args = ["--options-file", options_file, config_opt, tests_opt, overriding_options].compact
+
+  begin
+    sh("beaker", *args)
+  ensure
+    if (hosts_file = config || final_options[:hosts_file]) && hosts_file !~ /preserved_config/
+      cp(hosts_file, "log/latest/config.yml")
+      generate_config_for_latest_hosts if final_options[:preserve_hosts] || overriding_options =~ /--preserve-hosts/
+    end
+    mv(options_file, "log/latest")
+    puts "\n\n"
+  end
+end
+
+def generate_config_for_latest_hosts
+  preserved_config_hash = { 'HOSTS' => {} }
+
+  config_hash = YAML.load_file('log/latest/config.yml').to_hash
+  nodes = config_hash['HOSTS'].map do |node_label,hash|
+    { :node_label => node_label, :platform => hash['platform'] }
+  end
+
+  pre_suite_log = File.read('log/latest/pre_suite-run.log')
+  nodes.each do |node_info|
+    possible_hostname_match = /^(\w+) \(#{node_info[:node_label]}\)/.match(pre_suite_log)
+    hostname = (possible_hostname_match || Array.new)[1]
+    fqdn = hostname ? "#{hostname}.delivery.puppetlabs.net" : "unknown"
+    preserved_config_hash['HOSTS'][fqdn] = {
+      'roles' => [ 'agent'],
+      'platform' => node_info[:platform],
+    }
+    preserved_config_hash['HOSTS'][fqdn]['roles'].unshift('master') if node_info[:node_label] =~ /master/
+  end
+
+  puts "\n\n"
+  pp preserved_config_hash
+  puts "\n\n"
+
+  File.open('log/latest/preserved_config.yaml', 'w') do |config_file|
+    YAML.dump(preserved_config_hash, config_file)
+  end
+rescue Errno::ENOENT => e
+  puts "Couldn't generate log #{e}"
+end
+
+def list_preserved_configurations(secs_ago = ONE_DAY_IN_SECS)
+  preserved = {}
+  Dir.glob('log/*_*').each do |dir|
+    preserved_config_path = "#{dir}/preserved_config.yaml"
+    yesterday = Time.now - secs_ago.to_i
+    if preserved_config = File.exists?(preserved_config_path)
+      directory = File.new(dir)
+      if directory.ctime > yesterday
+        hosts = []
+        preserved_config = YAML.load_file(preserved_config_path).to_hash
+        preserved_config['HOSTS'].each do |hostname,values|
+          hosts << "#{hostname}: #{values['platform']}, #{values['roles']}"
+        end
+        preserved[hosts] = directory.to_path
+      end
+    end
+  end
+  preserved.map { |k,v| [v,k] }.sort { |a,b| a[0] <=> b[0] }.reverse
+end
+
+def list_preserved_hosts(secs_ago = ONE_DAY_IN_SECS)
+  hosts = Set.new
+  Dir.glob('log/**/pre*suite*run.log').each do |log|
+    yesterday = Time.now - secs_ago.to_i
+    File.open(log, 'r') do |file|
+      if file.ctime > yesterday
+        file.each_line do |line|
+          matchdata = /^(\w+) \(.*?\) \$/.match(line.encode!('UTF-8', 'UTF-8', :invalid => :replace))
+          hosts.add(matchdata[1]) if matchdata
+        end
+      end
+    end
+  end
+  hosts
+end
+
+# Plagiarized from Beaker::Vcloud#cleanup
+def destroy_preserved_hosts(hosts = nil, secs_ago = ONE_DAY_IN_SECS)
+  secs_ago ||= ONE_DAY_IN_SECS
+  hosts ||= list_preserved_hosts(secs_ago)
+
+  require 'beaker/hypervisor/vsphere_helper'
+  vsphere_credentials = VsphereHelper.load_config("#{ENV['HOME']}/.fog")
+
+  puts "Connecting to vSphere at #{vsphere_credentials[:server]}" +
+    " with credentials for #{vsphere_credentials[:user]}"
+
+  vsphere_helper = VsphereHelper.new( vsphere_credentials )
+
+  vm_names = hosts.to_a
+  pp vm_names
+  vms = vsphere_helper.find_vms vm_names
+  vm_names.each do |name|
+    unless vm = vms[name]
+      puts "Couldn't find VM #{name} in vSphere!"
+      next
+    end
+
+    if vm.runtime.powerState == 'poweredOn'
+      puts "Shutting down #{vm.name}"
+      start = Time.now
+      vm.PowerOffVM_Task.wait_for_completion
+      puts "Spent %.2f seconds halting #{vm.name}" % (Time.now - start)
+    end
+
+    start = Time.now
+    vm.Destroy_Task
+    puts "Spent %.2f seconds destroying #{vm.name}" % (Time.now - start)
+  end
+
+  vsphere_helper.close
+end
+
+def print_preserved(preserved)
+  preserved.each_with_index do |entry,i|
+    puts "##{i}: #{entry[0]}"
+    entry[1].each { |h| puts "  #{h}" }
+  end
+end
+
+def beaker_run_type
+  type = ENV['TYPE'] || :aio
+  type = type.to_sym
+end
+
+def sha
+  ENV['SHA']
+end
+
+def config
+  ENV['BEAKER_HOSTS']
+end
+
+namespace :ci do
+
+  task :check_env do
+    raise(USAGE) unless sha
+  end
+
+  namespace :test do
+
+    USAGE = <<-EOS
+Requires commit SHA to be put under test as environment variable: SHA='<sha>'.
+Also must set BEAKER_HOSTS=config/nodes/foo.yaml or include it in an options.rb for Beaker,
+or specify TEST_TARGET in a form beaker-hostgenerator accepts, e.g. ubuntu1504-64a.
+You may set TESTS=path/to/test,and/more/tests.
+You may set additional Beaker OPTIONS='--more --options'
+If testing from git checkouts, you may optionally set the github fork to checkout from using FORK='other-puppet-fork'.
+You may also optionally set the git server to checkout from using GIT_SERVER='my.host.with.git.daemon', if you have set up a `git daemon` to pull local commits from.  (In this case, the FORK should be set to the path to the repository, and you will need to allow the git daemon to serve the repo (see `git help daemon`)).
+If there is a Beaker options hash in a ./local_options.rb, it will be included.  Commandline options set through the above environment variables will override settings in this file.
+EOS
+
+    desc <<-EOS
+Run the acceptance tests through Beaker and install packages as part of the AIO puppet-agent installation.
+#{USAGE}
+EOS
+    task :aio => 'ci:check_env' do
+      beaker_test(:aio)
+    end
+
+    desc <<-EOS
+Run the acceptance tests through Beaker and install from git on the configuration targets.
+#{USAGE}
+EOS
+    task :git => 'ci:check_env' do
+      beaker_test(:git)
+    end
+  end
+
+  desc "Capture the master and agent hostname from the latest log and construct a preserved_config.yaml for re-running against preserved hosts without provisioning."
+  task :extract_preserved_config do
+    generate_config_for_latest_hosts
+  end
+
+  desc <<-EOS
+Run an acceptance test for a given node configuration and preserve the hosts.
+Defaults to a packages run, but you can set it to 'git' with TYPE='git'.
+#{USAGE}
+  EOS
+  task :test_and_preserve_hosts => 'ci:check_env'  do
+    beaker_test(beaker_run_type, :preserve_hosts => 'always', :__preserve_config__ => true)
+  end
+
+  desc "List acceptance runs from the past day which had hosts preserved."
+  task :list_preserved do
+    preserved = list_preserved_configurations
+    print_preserved(preserved)
+  end
+
+  desc <<-EOS
+Shutdown and destroy any hosts that we have preserved for testing.  These should be reaped daily by scripts, but this will free up resources immediately.
+Specify a list of comma separated HOST_NAMES if you have a set of dynamic vcloud host names you want to purge outside of what can be grepped from the logs.
+You can go back through the last SECS_AGO logs.  Default is one day ago in secs.
+  EOS
+  task :destroy_preserved_hosts do
+    host_names = ENV['HOST_NAMES'].split(',') if ENV['HOST_NAMES']
+    secs_ago = ENV['SECS_AGO']
+    destroy_preserved_hosts(host_names, secs_ago)
+  end
+
+  desc <<-EOS
+Rerun an acceptance test using the last captured preserved_config.yaml to skip provisioning.
+Or specify a CONFIG_NUMBER from `rake ci:list_preserved`.
+Uses the setup/rsync/pre-suite to rsync the local puppet source onto master and agent.
+You may specify an RSYNC_FILTER_FILE as well.
+You may skip purging and reinstalling puppet packages by including SKIP_PACKAGE_REINSTALL.
+You may skip rsyncing local puppet files over to the tests hosts by including SKIP_RSYNC.
+Defaults to an aio run, but you can set it to 'git' with TYPE='git'.
+  EOS
+  task :test_against_preserved_hosts do
+    config_number = (ENV['CONFIG_NUMBER'] || 0).to_i
+    preserved = list_preserved_configurations
+    print_preserved(preserved)
+    config_path = preserved[config_number][0]
+    puts "Using ##{config_number}: #{config_path}"
+    beaker_test(beaker_run_type,
+      :hosts_file => "#{config_path}/preserved_config.yaml",
+      :no_provision => true,
+      :preserve_hosts => 'always',
+      :pre_suite => ['setup/rsync/pre-suite']
+    )
+  end
+end
+
+task :default do
+  sh('rake -T')
+end