master_manipulator 1.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 82c90ccb9f7a1f77f034cb73f4c8d758d961cf34
+  data.tar.gz: 8547f78eb24085267afec5fd669d6be03acb3a38
+SHA512:
+  metadata.gz: 2ed736250d0ed64c218ede0274677eaa01b08079167f10f661a762aff0724f6285181e65326a3f777189bf7991bc4580abe47560c3409957f17c0595f83c364e
+  data.tar.gz: fa9927b9a7bd56d6a98ad6c1741c6eedd5415abb73544f0e756111d2691c7b1501a7e13ccf99163ea68dd2d5e31576792456d8b688f6223fd1df1330a743adf1

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+#this will probably not be available on rubygems, at least initially
+#will probably be only available at https://rubygems.delivery.puppetlabs.net
+#TODO: Change this line when it is actually available internally
+
+# Specify your gem's dependencies in master_manipulator.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,267 @@
+PATH
+  remote: .
+  specs:
+    master_manipulator (1.1.2)
+      beaker (~> 2.7, >= 2.7.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (2.3.1)
+    activesupport (4.2.3)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    addressable (2.3.8)
+    autoparse (0.3.3)
+      addressable (>= 2.3.1)
+      extlib (>= 0.9.15)
+      multi_json (>= 1.0.0)
+    aws-sdk (1.64.0)
+      aws-sdk-v1 (= 1.64.0)
+    aws-sdk-v1 (1.64.0)
+      json (~> 1.4)
+      nokogiri (>= 1.4.4)
+    beaker (2.18.0)
+      aws-sdk (~> 1.57)
+      docker-api
+      fission (~> 0.4)
+      fog (~> 1.25)
+      google-api-client (~> 0.8)
+      hocon (~> 0.1)
+      inifile (~> 2.0)
+      json (~> 1.8)
+      minitest (~> 5.4)
+      net-scp (~> 1.2)
+      net-ssh (~> 2.9)
+      open_uri_redirections (~> 0.2.1)
+      rbvmomi (~> 1.8)
+      rsync (~> 1.0.9)
+      unf (~> 0.1)
+    builder (3.2.2)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    docker-api (1.21.4)
+      excon (>= 0.38.0)
+      json
+    excon (0.45.4)
+    extlib (0.9.16)
+    faraday (0.9.1)
+      multipart-post (>= 1.2, < 3)
+    fission (0.5.0)
+      CFPropertyList (~> 2.2)
+    fog (1.32.0)
+      fog-atmos
+      fog-aws (>= 0.6.0)
+      fog-brightbox (~> 0.4)
+      fog-core (~> 1.32)
+      fog-ecloud (= 0.1.1)
+      fog-google (>= 0.0.2)
+      fog-json
+      fog-local
+      fog-powerdns (>= 0.1.1)
+      fog-profitbricks
+      fog-radosgw (>= 0.0.2)
+      fog-riakcs
+      fog-sakuracloud (>= 0.0.4)
+      fog-serverlove
+      fog-softlayer
+      fog-storm_on_demand
+      fog-terremark
+      fog-vmfusion
+      fog-voxel
+      fog-xml (~> 0.1.1)
+      ipaddress (~> 0.5)
+      nokogiri (~> 1.5, >= 1.5.11)
+    fog-atmos (0.1.0)
+      fog-core
+      fog-xml
+    fog-aws (0.7.3)
+      fog-core (~> 1.27)
+      fog-json (~> 1.0)
+      fog-xml (~> 0.1)
+      ipaddress (~> 0.8)
+    fog-brightbox (0.7.2)
+      fog-core (~> 1.22)
+      fog-json
+      inflecto (~> 0.0.2)
+    fog-core (1.32.0)
+      builder
+      excon (~> 0.45)
+      formatador (~> 0.2)
+      mime-types
+      net-scp (~> 1.1)
+      net-ssh (>= 2.1.3)
+    fog-ecloud (0.1.1)
+      fog-core
+      fog-xml
+    fog-google (0.0.7)
+      fog-core
+      fog-json
+      fog-xml
+    fog-json (1.0.2)
+      fog-core (~> 1.0)
+      multi_json (~> 1.10)
+    fog-local (0.2.1)
+      fog-core (~> 1.27)
+    fog-powerdns (0.1.1)
+      fog-core (~> 1.27)
+      fog-json (~> 1.0)
+      fog-xml (~> 0.1)
+    fog-profitbricks (0.0.3)
+      fog-core
+      fog-xml
+      nokogiri
+    fog-radosgw (0.0.4)
+      fog-core (>= 1.21.0)
+      fog-json
+      fog-xml (>= 0.0.1)
+    fog-riakcs (0.1.0)
+      fog-core
+      fog-json
+      fog-xml
+    fog-sakuracloud (1.0.1)
+      fog-core
+      fog-json
+    fog-serverlove (0.1.2)
+      fog-core
+      fog-json
+    fog-softlayer (0.4.7)
+      fog-core
+      fog-json
+    fog-storm_on_demand (0.1.1)
+      fog-core
+      fog-json
+    fog-terremark (0.1.0)
+      fog-core
+      fog-xml
+    fog-vmfusion (0.1.0)
+      fission
+      fog-core
+    fog-voxel (0.1.0)
+      fog-core
+      fog-xml
+    fog-xml (0.1.2)
+      fog-core
+      nokogiri (~> 1.5, >= 1.5.11)
+    formatador (0.2.5)
+    google-api-client (0.8.6)
+      activesupport (>= 3.2)
+      addressable (~> 2.3)
+      autoparse (~> 0.3)
+      extlib (~> 0.9)
+      faraday (~> 0.9)
+      googleauth (~> 0.3)
+      launchy (~> 2.4)
+      multi_json (~> 1.10)
+      retriable (~> 1.4)
+      signet (~> 0.6)
+    googleauth (0.4.1)
+      faraday (~> 0.9)
+      jwt (~> 1.4)
+      logging (~> 2.0)
+      memoist (~> 0.12)
+      multi_json (= 1.11)
+      signet (~> 0.6)
+    hocon (0.9.2)
+    i18n (0.7.0)
+    inflecto (0.0.2)
+    inifile (2.0.2)
+    ipaddress (0.8.0)
+    json (1.8.3)
+    jwt (1.5.1)
+    kramdown (1.8.0)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    little-plugger (1.1.3)
+    logging (2.0.0)
+      little-plugger (~> 1.1)
+      multi_json (~> 1.10)
+    logutils (0.6.1)
+    markdown (0.4.0)
+      kramdown (>= 0.13.7)
+      props (>= 0.2.0)
+      textutils (>= 0.2.0)
+    memoist (0.12.0)
+    method_source (0.8.2)
+    mime-types (2.6.1)
+    mini_portile (0.6.2)
+    minitest (5.7.0)
+    multi_json (1.11.0)
+    multipart-post (2.0.0)
+    net-scp (1.2.1)
+      net-ssh (>= 2.6.5)
+    net-ssh (2.9.2)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    open_uri_redirections (0.2.1)
+    props (1.1.2)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.4.2)
+    rbvmomi (1.8.2)
+      builder
+      nokogiri (>= 1.4.1)
+      trollop
+    retriable (1.4.1)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.1)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    rsync (1.0.9)
+    rubyzip (1.1.7)
+    signet (0.6.1)
+      addressable (~> 2.3)
+      extlib (~> 0.9)
+      faraday (~> 0.9)
+      jwt (~> 1.5)
+      multi_json (~> 1.10)
+    simplecov (0.10.0)
+      docile (~> 1.1.0)
+      json (~> 1.8)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    slop (3.6.0)
+    textutils (1.3.1)
+      activesupport
+      logutils (>= 0.6.1)
+      props (>= 1.1.2)
+      rubyzip
+    thread_safe (0.3.5)
+    trollop (2.1.2)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.1)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.6)
+  markdown (~> 0)
+  master_manipulator!
+  pry (~> 0.9.12)
+  rake
+  rspec (>= 3.0.0)
+  simplecov
+  yard (~> 0)
+
+BUNDLED WITH
+   1.10.5

data/HISTORY.md

@@ -0,0 +1,98 @@
+# default - History
+## Tags
+* [LATEST - 1 Jul, 2015 (14ceb0e8)](#LATEST)
+* [1.1.0 - 30 Jun, 2015 (c33bac06)](#1.1.0)
+* [1.0.1 - 17 Jun, 2015 (33c2182d)](#1.0.1)
+* [1.0.0 - 6 May, 2015 (8ae50d90)](#1.0.0)
+
+## Details
+### <a name = "LATEST">LATEST - 1 Jul, 2015 (14ceb0e8)
+
+* (GEM) update master_manipulator version to 1.1.1 (14ceb0e8)
+
+* Merge pull request #10 from cowofevil/bug/master/QA-1935/fix_perms_on_site_pp (ebb0e478)
+
+
+```
+Merge pull request #10 from cowofevil/bug/master/QA-1935/fix_perms_on_site_pp
+
+(QA-1935) Fix "inject_site_pp" Issue
+```
+* (QA-1935) Fix "inject_site_pp" Issue (338a6d40)
+
+
+```
+(QA-1935) Fix "inject_site_pp" Issue
+
+The wrong mode was being set on the "site.pp" which made Puppet unable
+to read the file.
+```
+### <a name = "1.1.0">1.1.0 - 30 Jun, 2015 (c33bac06)
+
+* (HISTORY) update master_manipulator history for gem release 1.1.0 (c33bac06)
+
+* (GEM) update master_manipulator version to 1.1.0 (53e5d02b)
+
+* Merge pull request #9 from cowofevil/feature/master/QA-1934/get_manifests_path (0f86d431)
+
+
+```
+Merge pull request #9 from cowofevil/feature/master/QA-1934/get_manifests_path
+
+(QA-1934) Add New Methods
+```
+* (QA-1934) Add New Methods (27c1d815)
+
+
+```
+(QA-1934) Add New Methods
+
+Add methods for retrieving the location of environment manifests.
+Update the README to include actual documentation.
+```
+* Merge pull request #8 from zreichert/improve_restart-puppet-server (f245c951)
+
+
+```
+Merge pull request #8 from zreichert/improve_restart-puppet-server
+
+Improve restart puppet server
+```
+* (QA-1930) add option is_pe? (14184e40)
+
+* (QA-1930) simplify curl call (5d0b0362)
+
+* (QA-1930) update restart_puppet_server timeout default to 60 (f9435b7c)
+
+* (QA-1930) improve error msg  & new spec test (6eec120d)
+
+* (QA-1930) refactor to use case statement (d9d5f428)
+
+### <a name = "1.0.1">1.0.1 - 17 Jun, 2015 (33c2182d)
+
+* (HISTORY) update master_manipulator history for gem release 1.0.1 (33c2182d)
+
+* (GEM) update master_manipulator version to 1.0.1 (a2140d3d)
+
+* Merge pull request #7 from cowofevil/bug/master/QA-1928_fix_bug (51950027)
+
+
+```
+Merge pull request #7 from cowofevil/bug/master/QA-1928_fix_bug
+
+(QA-1928) Fix Bug
+```
+* (QA-1928) Fix for the fix (e6c4bb69)
+
+* (QA-1928) Fix Bug (d2f56fdd)
+
+
+```
+(QA-1928) Fix Bug
+
+The "set_perms_on_remote" method fails to set ownership on a file and is
+now fixed!
+```
+### <a name = "1.0.0">1.0.0 - 6 May, 2015 (8ae50d90)
+
+* Initial release.

data/LICENSE.txt

@@ -0,0 +1,15 @@
+Copyright (C) 2011-2013 Puppet Labs Inc
+
+   Puppet Labs can be contacted at: info@puppetlabs.com
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,127 @@
+# Master Manipulator
+
+This Gem extends the Beaker DSL for the purpose of changing things on a
+Puppet Master.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'master_manipulator'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install master_manipulator
+
+## Methods
+
+### disable_node_classifier
+
+Disable the node classifier on a Puppet Enterprise master and use the "site.pp"
+manifest instead for node classification.
+
+#### Example
+
+    disable_node_classifier(master)
+
+### disable_env_cache
+
+Disable environment caching on a Puppet Enterprise master to allow for dynamic
+updates to environments without waiting for cache purge.
+
+#### Example
+
+    disable_env_cache(master)
+
+### restart_puppet_server
+
+Restart the Puppet Server service to pickup configuration changes made to the
+"puppet.conf" file.
+
+#### Example
+
+Restart the Puppet Server service on Puppet Enterprise:
+
+    restart_puppet_server(master)
+
+### get_manifests_path
+
+Retrieve the path to the manifests folder for an environment on a master.
+
+#### Example 1
+
+Retrieve the path to the manifests folder for the "production" environment.
+
+    prod_env_manifests_path = get_manifests_path(master)
+
+#### Example 2
+
+Retrieve the path to the manifests folder for the "staging" environment.
+
+    stage_env_manifests_path = get_manifests_path(master, :env => 'staging')
+
+### get_site_pp_path
+
+Retrieve the path to the "site.pp" manifest for an environment on a master.
+
+#### Example 1
+
+Retrieve the path to the "site.pp" manifest for the "production" environment.
+
+    prod_env_site_pp_path = get_site_pp_path(master)
+
+#### Example 2
+
+Retrieve the path to the "site.pp" manifest for the "production" environment.
+
+    stage_env_site_pp_path = get_site_pp_path(master, :env => 'staging')
+
+### create_site_pp
+
+Create a "site.pp" file with file bucket enabled. Also, allow the creation of a
+custom node definition or use the 'default' node definition.
+
+#### Example 1
+
+Create a "site.pp" manifest with the default node definition using a simple
+manifest.
+
+    site_pp = create_site_pp(master, :manifest => 'notify { hello: }')
+
+#### Example 2
+
+Create a "site.pp" manifest with a custom node definition using a simple
+manifest.
+
+    site_pp = create_site_pp(master, :node_def_name => 'puppet_agent', :manifest => 'notify { hello: }')
+
+### set_perms_on_remote
+
+Set permissions and ownership on a remote file.
+
+#### Example 1
+
+Set permissions on the "site.pp" manifest with default ownership of Pupppet
+user and group.
+
+    set_perms_on_remote(master, get_site_pp_path(master), '644')
+
+#### Example 2
+
+Set permissions on the "site.pp" manifest with root ownership.
+
+    set_perms_on_remote(master, get_site_pp_path(master), '644', :owner => 'root', :group => 'root')
+
+### inject_site_pp
+
+Inject a "site.pp" manifest onto a master.
+
+#### Example
+
+    prod_env_site_pp_path = get_site_pp_path(master)
+    site_pp = create_site_pp(master, :manifest => 'notify { hello: }')
+    inject_site_pp(master, prod_env_site_pp_path, site_pp)

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+
+task :default => :test
+
+desc "Run spec tests"
+RSpec::Core::RakeTask.new(:test) do |t|
+  t.rspec_opts = ['--color']
+  t.pattern = 'spec/'
+end

data/lib/master_manipulator.rb

@@ -0,0 +1,13 @@
+require 'master_manipulator/version'
+require 'beaker'
+
+module Beaker
+  class TestCase
+    %w( config service site ).each do |lib|
+      require "master_manipulator/#{lib}"
+    end
+    include MasterManipulator::Config
+    include MasterManipulator::Service
+    include MasterManipulator::Site
+  end
+end

data/lib/master_manipulator/config.rb

@@ -0,0 +1,39 @@
+module MasterManipulator
+  module Config
+
+    # Disable the Node Classifier on the Puppet master.
+    # (Note: this requires a restart of Puppet Server to take affect.)
+    # ==== Attributes
+    #
+    # * +master_host+ - The master running Puppet Server.
+    #
+    # ==== Returns
+    #
+    # nil
+    #
+    # ==== Examples
+    #
+    # site_pp = disable_node_classifier(master_host)
+    def disable_node_classifier(master_host)
+      on(master_host, puppet('config set node_terminus plain --section master'))
+    end
+
+    # Disable environment caching on the Puppet master.
+    # (Note: this requires a restart of Puppet Server to take affect.)
+    # ==== Attributes
+    #
+    # * +master_host+ - The master running Puppet Server.
+    #
+    # ==== Returns
+    #
+    # nil
+    #
+    # ==== Examples
+    #
+    # site_pp = disable_node_classifier(master_host)
+    def disable_env_cache(master_host)
+      on(master_host, puppet('config set environment_timeout 0 --section main'))
+    end
+
+  end
+end

data/lib/master_manipulator/service.rb

@@ -0,0 +1,51 @@
+module MasterManipulator
+  module Service
+
+    # Restart the puppet server and wait for it to come back up
+    # ==== Attributes
+    # *+host+ - the host that this should operate on
+    # *+opts+ - an options hash - not required
+    #   *+:timeout+ - the amount of time in seconds to wait for success
+    #   *+:frequency+ - The time to wait between retries
+    #   *+:is_pe?+ - Boolean : if the SUT is PE, defaults to true
+    #
+    # Raises a standard error if the wait is unsuccessful
+    #
+    # ==== Example
+    # restart_puppet_server(master)
+    # restart_puppet_server(master, {:time_out => 200, :frequency => 10})
+    def restart_puppet_server(host, opts = {})
+
+      opts[:is_pe?] ||= true
+      opts[:is_pe?] ? service_name = 'pe-puppetserver' : service_name = 'puppetserver'
+
+      on(host, puppet("resource service #{service_name} ensure=stopped"))
+      on(host, puppet("resource service #{service_name} ensure=running"))
+      masterHostName = on(host, 'hostname').stdout.chomp
+      opts[:time_out] ||= 60
+      opts[:frequency] ||= 5
+      i = 0
+
+      # -k to ignore HTTPS error that isn't relevant to us
+      curl_call = "-I -k https://#{masterHostName}:8140"
+
+      while i < opts[:time_out] do
+        i += 1
+        exit_code = curl_on(host, curl_call, :acceptable_exit_codes => [0,1,7]).exit_code
+        case exit_code.to_s
+          when '0'
+            sleep 20
+            return
+          when '1' || '7'
+            # Exit code 7 is "connection refused"
+            sleep opts[:frequency]
+        end
+      end
+
+      message = "Attempted to restart #{i} times, waited #{opts[:frequency]} seconds between attempts."
+      raise message
+
+    end
+
+  end
+end

data/lib/master_manipulator/site.rb

@@ -0,0 +1,146 @@
+module MasterManipulator
+  module Site
+
+    # Get the location of an environment's manifests path. (Defaults to "production" environment.)
+    #
+    # ==== Attributes
+    #
+    # * +master_host+ - The master host that contains environments.
+    # * +opts:env+ - The environment from which to discover the manifests path.
+    #
+    # ==== Returns
+    #
+    # +string+ - An absolute path to the manifests for an environment on the master host.
+    #
+    # ==== Examples
+    #
+    # prod_env_manifests_path = get_manifests_path(master)
+    def get_manifests_path(master_host, opts = {})
+      opts[:env] ||= 'production'
+
+      environment_base_path = on(master_host, puppet('config print environmentpath')).stdout.rstrip
+
+      return File.join(environment_base_path, opts[:env], 'manifests')
+    end
+
+    # Get the location of an environment's "site.pp" path. (Defaults to "production" environment.)
+    #
+    # ==== Attributes
+    #
+    # * +master_host+ - The master host that contains environments.
+    # * +opts:env+ - The environment from which to discover the "site.pp" path.
+    #
+    # ==== Returns
+    #
+    # +string+ - An absolute path to the "site.pp" for an environment on the master host.
+    #
+    # ==== Examples
+    #
+    # prod_env_site_pp_path = get_site_pp_path(master)
+    def get_site_pp_path(master_host, opts = {})
+      opts[:env] ||= 'production'
+
+      return File.join(get_manifests_path(master_host, opts), 'site.pp')
+    end
+
+    # Create a "site.pp" file with file bucket enabled. Also, allow
+    # the creation of a custom node definition or use the 'default'
+    # node definition.
+    #
+    # ==== Attributes
+    #
+    # * +master_host+ - The target master for "site.pp" injection.
+    # * +opts:manifest+ - A Puppet manifest to inject into the node definition.
+    # * +opts:node_def_name+ - A node definition pattern or name.
+    #
+    # ==== Returns
+    #
+    # +string+ - A combined manifest with node definition containing input manifest
+    #
+    # ==== Examples
+    #
+    # site_pp = create_site_pp(master, '', node_def_name='agent')
+    def create_site_pp(master_host, opts = {})
+      opts[:manifest] ||= ''
+      opts[:node_def_name] ||= 'default'
+      master_certname = on(master_host, puppet('config print certname')).stdout.rstrip
+
+      default_def = <<-MANIFEST
+node default {
+}
+MANIFEST
+
+      node_def = <<-MANIFEST
+node #{opts[:node_def_name]} {
+
+#{opts[:manifest]}
+}
+MANIFEST
+
+      if opts[:node_def_name] != 'default'
+        node_def = "#{default_def}\n#{node_def}"
+      end
+
+      site_pp = <<-MANIFEST
+filebucket { 'main':
+  server => '#{master_certname}',
+  path   => false,
+}
+
+File { backup => 'main' }
+
+#{node_def}
+MANIFEST
+
+      return site_pp
+    end
+
+    # Set mode, owner and group on a remote path.
+    #
+    # ==== Attributes
+    #
+    # * +host+ - The remote host containing the target path.
+    # * +path+ - The path to set mode, user and group upon.
+    # * +mode+ - The desired mode to set on the path in as a string.
+    # * +opts:owner+ - The owner to set on the path. (Puppet user if not specified.)
+    # * +opts:group+ - The group to set on the path. (Puppet group if not specified.)
+    #
+    # ==== Returns
+    #
+    # nil
+    #
+    # ==== Examples
+    #
+    # set_perms_on_remote(master, "/tmp/test/site.pp", "777")
+    def set_perms_on_remote(host, path, mode, opts = {})
+      opts[:owner] ||= on(host, puppet('config print user')).stdout.rstrip
+      opts[:group] ||= on(host, puppet('config print group')).stdout.rstrip
+
+      on(host, "chmod -R #{mode} #{path}")
+      on(host, "chown -R #{opts[:owner]}:#{opts[:group]} #{path}")
+    end
+
+    # Inject a "site.pp" manifest onto a master.
+    #
+    # ==== Attributes
+    #
+    # * +master_host+ - The target master for injection.
+    # * +site_pp_path+ - A path on the remote host into which the site.pp will be injected.
+    # * +manifest+ - The manifest content to inject into "site.pp" to the host target path.
+    #
+    # ==== Returns
+    #
+    # nil
+    #
+    # ==== Examples
+    #
+    # site_pp = inject_site_pp(master_host, "/tmp/test/site.pp", manifest)
+    def inject_site_pp(master_host, site_pp_path, manifest)
+      site_pp_dir = File.dirname(site_pp_path)
+      create_remote_file(master_host, site_pp_path, manifest)
+
+      set_perms_on_remote(master_host, site_pp_dir, '744')
+    end
+
+  end
+end

data/lib/master_manipulator/version.rb

@@ -0,0 +1,5 @@
+module MasterManipulator
+  module Version
+    STRING = '1.1.2'
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require 'simplecov'
+require 'rspec'
+
+SimpleCov.start
+
+require 'master_manipulator'
+
+RSpec.configure do |c|
+
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: master_manipulator
+version: !ruby/object:Gem::Version
+  version: 1.1.2
+platform: ruby
+authors:
+- Puppet Labs
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.12
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: beaker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+description: This Gem extends the Beaker DSL for the purpose of changing things on
+  a Puppet Master.
+email:
+- qa@puppetlabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- HISTORY.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/master_manipulator.rb
+- lib/master_manipulator/config.rb
+- lib/master_manipulator/service.rb
+- lib/master_manipulator/site.rb
+- lib/master_manipulator/version.rb
+- spec/spec_helper.rb
+homepage: https://github.com/puppetlabs/master_manipulator
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Puppet Labs testing library for controlling a Puppet Master
+test_files:
+- spec/spec_helper.rb
+has_rdoc: