beaker 2.44.0 → 2.45.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NzkwYzhjYjQ1MzhmOWIxMTQ0MmNmNmE1Mjk3ZjEzYWFlMjhjMTQzMQ==
+    ZWY3ZTBjNzU5ZTJlYWVlYzJmOWRlZjQ1NTBlZjQ2ZWIzZWFlNTNiNQ==
   data.tar.gz: !binary |-
-    MmI4ZTk0ZmEwMjkxYjRhZjlmZGNiMzljZmZlZmM2NzkxZTY3NmJjNQ==
+    NDgwZWI3NWIyY2NmMWVhNmQxYWE3MGNiMjk0M2NlZmQ1MzYwMmJjZA==
 SHA512:
   metadata.gz: !binary |-
-    YmY4YTg1ZWEyNjE0OTMwYjZiNjQ3YWM0YzU3YTlhNGMzNDAxMWUzNjgyOWVh
-    MWM2MWQ3N2UzZDBiNDhiMDY5NGI2MWYzOTNlYjhhYWVkMTBkNTFmYjFiM2Zl
-    MWU5ZGMwOGZhNDBhMDk3ZDE0OGU0YmY3ZTE5N2QzZTk2NGU4Y2M=
+    NDkzNzZiZDQ1MDQ5NGViYTJiNTI3MTE0ODQyZGM1Yzc3YzRiZGQ2OGY4NzUz
+    Zjg1NjMwMjdlZTA3MjNhYmI3MjczOWYwOGFiN2EzNWNhZDI5NDY0ZDhlMGNl
+    Nzc5YTIxMjVmMDlkMjJlMmUzNzVkNThiYTg0NzcxNDljYzcyOGM=
   data.tar.gz: !binary |-
-    ZjlhNzg0OGJmOTM3YTkzZGU1YTQ1YjZkODE5ZGZjMGY5ODMxYjRjMDRhNjY1
-    OTE3ZGRjZTEwNzcxMmU4MmNmYjZjNTc2YTBmMjM4NDVjMGI2M2RkMjU3N2Nh
-    NzMxY2ViMzcxMThjODllYjVjM2E1ZDc5NGVhYzk5YjM5NTlhY2Y=
+    NTFkNTU0OTBhMGMyZWI3OWI0MmI5YmQ5ZTJjNGM5NTQ3MjIyNzdlZTVjODUx
+    MDkxYmU0MzE1ZjhjZTNmOGI4NDA5MzY0M2QyNWJlODUxODAxYjQyY2NiMzdj
+    OWRkNDNiYTU3MjY0NWU5MzM3MGRmY2Y3NDY1NjczMjNlZGY3N2Q=

data/CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 ## Getting Started
 
-* Create a [Jira account](http://tickets.puppetlabs.com)
+* If it is accessible to you, create a [Jira account](http://tickets.puppetlabs.com)
 * Make sure you have a [GitHub account](https://github.com/signup/free)
 * Submit a ticket for your issue, assuming one does not already exist.
   * Clearly describe the issue including steps to reproduce when it is a bug.
@@ -46,8 +46,13 @@
 
 ### Maintenance
 
-**We are no longer accepting PRs marked as `(MAINT)` - all PRs must be associated with a Beaker Jira ticket number for book keeping purposes.**
+For changes of a trivial nature, it is not always necessary to create a new ticket in Jira. In this case, it is appropriate to start the first line of a commit with `(MAINT)` instead of a ticket/issue number. 
 
+````
+    (MAINT) Fix whitespace 
+
+    - remove additional spaces that appear at EOL
+````
 ### Version Bump For Gem Release
 
 To prepare for a new gem release of Beaker the `version.rb` file is updated with the upcoming gem version number.  This is submitted with `(GEM)` instead of a ticket/issue number.

data/HISTORY.md

@@ -1,6 +1,7 @@
 # default - History
 ## Tags
-* [LATEST - 9 Jun, 2016 (0d267d3d)](#LATEST)
+* [LATEST - 29 Jun, 2016 (428f959a)](#LATEST)
+* [2.44.0 - 9 Jun, 2016 (38dfb77f)](#2.44.0)
 * [2.43.0 - 1 Jun, 2016 (777469ca)](#2.43.0)
 * [2.42.0 - 23 May, 2016 (c245fef7)](#2.42.0)
 * [2.41.0 - 10 May, 2016 (17c745bd)](#2.41.0)
@@ -120,7 +121,204 @@
 * [pe1.2 - 6 Sep, 2011 (ba3dadd2)](#pe1.2)
 
 ## Details
-### <a name = "LATEST">LATEST - 9 Jun, 2016 (0d267d3d)
+### <a name = "LATEST">LATEST - 29 Jun, 2016 (428f959a)
+
+* (GEM) update beaker version to 2.45.0 (428f959a)
+
+* Merge pull request #1143 from kevpl/bkr814_error_output (61343618)
+
+
+```
+Merge pull request #1143 from kevpl/bkr814_error_output
+
+(MAINT) improved error output from beaker-hostgenerator workflow
+```
+* Merge pull request #1161 from johnduarte/bkr-856-add-el-sles-to-remove-puppet (2a9070cd)
+
+
+```
+Merge pull request #1161 from johnduarte/bkr-856-add-el-sles-to-remove-puppet
+
+(BKR-856) Add el/sles support to remove_puppet_on
+```
+* (BKR-799) Use DNF for Uninstall Fedora 22+ (#1156) (e1e6c5e5)
+
+
+```
+(BKR-799) Use DNF for Uninstall Fedora 22+ (#1156)
+
+* Missed out in original PR
+```
+* Merge pull request #1162 from puppetlabs/revert-974-maint (e71875c9)
+
+
+```
+Merge pull request #1162 from puppetlabs/revert-974-maint
+
+Revert "(BKR-568) no longer accept PRs marked as "(MAINT)""
+```
+* Revert "(BKR-568) no longer accept PRs marked as "(MAINT)"" (1397371a)
+
+* (BKR-856) Add el/sles support to remove_puppet_on (50bca276)
+
+
+```
+(BKR-856) Add el/sles support to remove_puppet_on
+
+This commit expands platform support for the `remove_puppet_on` install
+helper method to include `sles` and all `el` derivatives.
+
+This allows hosts declared with a `hypervisor` of `none` on these
+platforms to have puppet uninstalled as part of a pre-suite.
+```
+* (BKR-355) - Adding acceptance tests for web_helper methods. (#1140) (43f41603)
+
+
+```
+(BKR-355) - Adding acceptance tests for web_helper methods. (#1140)
+
+* (BKR-355) - Adding acceptance tests for web_helper methods.
+
+* (BKR-355) - changes based on comments
+
+* (BKR-355) Moving test to puppet level so that ruby is installed for these tests.
+```
+* (MAINT) Changed link for lxc hypervisor (#1158) (07ae263f)
+
+* (BKR-24) Added "change_terminal_output_coloring.md" to describe how to change terminal colors in Beaker. (#1153) (128dae6d)
+
+
+```
+(BKR-24) Added "change_terminal_output_coloring.md" to describe how to change terminal colors in Beaker. (#1153)
+
+[skip ci]
+```
+* (MAINT) Fix typo (#1157) (695b6ef1)
+
+* (BKR-853) Update epel_url and epel_7_pkg presets (#1155) (c27113e1)
+
+
+```
+(BKR-853) Update epel_url and epel_7_pkg presets (#1155)
+
+* (BKR-853) Update epel_7_pkg preset
+
+* (BKR-853) Use master mirror for epel_url preset
+
+This changes the default to point to the master mirror outlined in the
+documentation here: https://fedoraproject.org/wiki/EPEL/FAQ
+
+* (BKR-853) Update spec tests for epel preset changes
+```
+* Merge pull request #1141 from Iristyle/maint/master/log-windows-versions-fix (ad6bf66e)
+
+
+```
+Merge pull request #1141 from Iristyle/maint/master/log-windows-versions-fix
+
+(maint) Extra quoting for Windows versions.txt
+```
+* (BKR-840) Added a new file test_run.md and deleted Overview.md (#1147) (fdd2c7e3)
+
+
+```
+(BKR-840) Added a new file test_run.md and deleted Overview.md (#1147)
+
+Removed extra space from README.md
+Added logger.rb
+[skip ci]
+```
+* (BKR-843) Use hypervisor specific logic for ip (#1149) (9b4f088d)
+
+
+```
+(BKR-843) Use hypervisor specific logic for ip (#1149)
+
+* (BKR-843) Use hypervisor specific logic for ip
+
+When determining the ip address of a machine, beaker normally ssh'd into
+the box and would run a command that would return the ip configured on
+that box. However, this doesn't work for several cloud hypervisors, as
+the public ip of the box may not match the internally configured ip
+address. This change allows for hypervisor specific logic to be executed
+instead of sshing into the box. Specifically, this commit changes all
+ec2 instances to use the public ip address instead of the private one.
+
+* (BKR-843) Curl ec2 for ip in case of --no-provision
+
+When there is no ec2 instance object created, the #get_public_ip method
+needs to use curl on the box instead of using the instance object to
+determine its ip. This will be the case when users add the no-provision
+flag.
+
+* (BKR-843) Add case for Windows ec2 instances for #get_public_ip
+```
+* (maint) link to beaker template from beaker library docs (#1142) (e2da65b8)
+
+
+```
+(maint) link to beaker template from beaker library docs (#1142)
+
+beaker-library howto is tough to find from beaker docs. This change
+links to it from the beaker-library list in docs
+
+[skip ci]
+```
+* (MAINT) Fix broken link to Vagrant Hosts examples (#1145) (f5b28947)
+
+* (MAINT) improved error output from beaker-hostgenerator workflow (8d22da0a)
+
+* Merge pull request #1130 from kevpl/bkr814_hostgenerator_syntax (806e6fa8)
+
+
+```
+Merge pull request #1130 from kevpl/bkr814_hostgenerator_syntax
+
+(BKR-814) added beaker-hostgenerator syntax to hosts arg
+```
+* (maint) Extra quoting for Windows versions.txt (36d7cbe9)
+
+
+```
+(maint) Extra quoting for Windows versions.txt
+
+ - Adds quotes around the "if exist path type path" command passed to
+   cmd.exe, which also requires that quotes around filenames have
+   their quoting escaped
+```
+* (BKR-685) Support openstack user_data (#1135) (5446a768)
+
+
+```
+(BKR-685) Support openstack user_data (#1135)
+
+* (BKR-685) Support openstack user_data
+
+* (BKR-685) add tests for Openstack hypervisor
+
+* (BKR-685) refactor openstack spec
+
+* (BKR-685) remove duplicate snapshot key
+
+* (BKR-685) add user_data field to openstack dock file
+```
+* (BKR-827) Vagrant port forwarding (#1133) (7090641f)
+
+
+```
+(BKR-827) Vagrant port forwarding (#1133)
+
+* (BKR-827) Adding port forwarding support.
+
+* (BKR-827) Adding support for all vagrant parameters.
+
+* (BKR-827) Adding documentation.
+```
+* (BKR-814) added beaker-hostgenerator syntax to hosts arg (6e15ae58)
+
+### <a name = "2.44.0">2.44.0 - 9 Jun, 2016 (38dfb77f)
+
+* (HISTORY) update beaker history for gem release 2.44.0 (38dfb77f)
 
 * (GEM) update beaker version to 2.44.0 (0d267d3d)
 

data/acceptance/tests/puppet/web_helpers_test.rb

@@ -0,0 +1,55 @@
+require 'helpers/test_helper'
+require 'webrick'
+require 'webrick/https'
+
+test_name 'dsl::helpers::web_helpers #link_exists?' do
+  cert_name = [
+      %w[CN localhost],
+  ]
+  http_cmd = "ruby -rwebrick -e'WEBrick::HTTPServer.new(:Port => 80, :DocumentRoot => \"/tmp\").start' > /tmp/mylogfile 2>&1 &"
+  https_cmd = "ruby -rwebrick/https -e'WEBrick::HTTPServer.new(:SSLEnable => true, :SSLCertName => #{cert_name}, :Port => 555,:DocumentRoot => \"/tmp\").start' > /tmp/mylogfile 2>&1 &"
+  on(default, http_cmd)
+  on(default, https_cmd)
+  #allow web servers to start up
+  sleep(3)
+  dir = default.tmpdir('test_dir')
+  file = default.tmpfile('test_file')
+  dir.slice! "/tmp"
+  file.slice! "/tmp"
+  dst_dir = 'web_helpers'
+
+  step '#port_open_within? can tell if a port is open' do
+    assert port_open_within?(default,80)
+  end
+
+  step '#link_exists? can tell if a basic link exists' do
+    assert link_exists?("http://#{default}")
+  end
+
+  step '#link_exists? can tell if a basic link does not exist' do
+    assert !link_exists?("http://#{default}/test")
+  end
+
+  step '#link_exists? can use an ssl link' do
+    assert link_exists?("https://#{default}:555")
+  end
+
+  step '#fetch_http_dir can fetch a dir' do
+    assert_equal "#{dst_dir}#{dir}", fetch_http_dir("http://#{default}/#{dir}", dst_dir)
+  end
+
+  step '#fetch_http_dir will raise an error if unable fetch a dir' do
+    exception = assert_raises(RuntimeError) { fetch_http_dir("http://#{default}/tmps", dst_dir) }
+    assert_match /Failed to fetch_remote_dir.*/, exception.message, "#fetch_http_dir raised an unexpected RuntimeError"
+  end
+
+  step '#fetch_http_file can fetch a file' do
+    assert_equal "#{dst_dir}#{file}", fetch_http_file("http://#{default}", file, dst_dir)
+  end
+
+  step '#fetch_http_file will raise an error if unable to fetch a file' do
+    exception = assert_raises(RuntimeError) { fetch_http_file("http://#{default}", "test2.txt", dst_dir) }
+    assert_match /Failed to fetch_remote_file.*/, exception.message, "#fetch_http_dir raised an unexpected RuntimeError"
+  end
+
+end

data/docs/Beaker-Libraries.md

@@ -2,6 +2,8 @@
 Engineering at Puppet Labs has written several libraries that extends the functionality provided
 by Beaker.
 
+To learn how to create beaker libraries, see the [Beaker-Template](https://github.com/puppetlabs/beaker-template/blob/master/README.md) documentation.
+
 | Name               | Description                                                         | Docs                                                            |
 |:-------------------|:--------------------------------------------------------------------|:----------------------------------------------------------------|
 | Master Manipulator | Easy DSL extension for changing configuration on a Puppet Master    | [Github Repo](https://github.com/puppetlabs/master_manipulator) |

data/docs/How-To-Beaker.md

@@ -1,4 +1,3 @@
-* [Overview](Overview.md)
 * [Beaker Installation](Beaker-Installation.md)
 * [Creating A Test Environment](Creating-A-Test-Environment.md)
 * [The Command Line](The-Command-Line.md)

data/docs/README.md

@@ -4,8 +4,8 @@
 
 * [MAINTAINERS](/MAINTAINERS.md)
 * [Installing Beaker](Beaker-Installation.md)
+* [Running Beaker Tests ](runner/test_run.md)
 * [How to Beaker](How-To-Beaker.md)
-  * [Overview](Overview.md)
   * [Creating A Test Environment](Creating-A-Test-Environment.md)
     * [Roles, What Are They?](Roles-What-Are-They.md)
     * [Supported Virtualization Techniques - Hypervisor Docs](hypervisors)

data/docs/how_to/change_terminal_output_coloring.md

@@ -0,0 +1,32 @@
+
+Beaker uses a set of colors to output different types of messages on to the terminal.
+
+## The Default Color Codes
+   If you do not provide any values, the defaults are: [Default colors](https://github.com/puppetlabs/beaker/blob/master/lib/beaker/logger.rb#L85-L95)
+
+## Beaker Color Codes:
+In addition, Beaker can support few other colors. List of all colors supported by Beaker:  [Colors Supported by Beaker] (https://github.com/puppetlabs/beaker/blob/master/lib/beaker/logger.rb#L14-L32)
+
+## How to Customize:
+Changes to the default options can be made by editing the configuration file.
+
+Here are some examples:
+
+**Eg 1: Changing color of a particular type of message**
+Add the following to the hosts file to change the color of `success` messages to `GREEN` and `warning` messages to `YELLOW`. 
+To get the color-code corresponding to a color, refer to: [Colors Supported by Beaker] (https://github.com/puppetlabs/beaker/blob/master/lib/beaker/logger.rb#L14-L32)
+
+      HOSTS:
+        ...
+      CONFIG:
+        log_colors:
+          success: "\e[01;35m"
+          warn: "\e[00;33m"
+
+**Eg 2: Turning off colors.**
+The following option in the hosts file will print the whole output in one single color.
+
+      HOSTS:
+        ...
+      CONFIG:
+        color: false

data/docs/hypervisors/README.md

@@ -22,4 +22,4 @@ trying to support a new hypervisor yourself.
 
 | Hypervisor | Fork                                               |
 |:----------:|:--------------------------------------------------:|
-| LXC        | [ashish1099](https://github.com/ashish1099/beaker) |
+| LXC        | [Obmondo](https://github.com/Obmondo/beaker) |

data/docs/hypervisors/openstack.md

@@ -1,8 +1,41 @@
-This options allows for testing against Openstack instances.
+# Openstack
+
+OpenStack is a free and open-source software platform for cloud computing. [Their Site](http://www.openstack.org/).
 
 Considered **EXPERIMENTAL**, may break without notice.
 
-### Basic Openstack hosts file ###
+# Getting Started
+
+### Requirements
+
+Get openstack Access & Security credentials:
+
+- "openstack_api_key"
+- "openstack_auth_url" 
+- "openstack_username"
+- "openstack_tenant"
+- "openstack_network"
+- "openstack_keyname"
+
+If you are using [OpenStack Dashboard "Horizon"] (https://wiki.openstack.org/wiki/Horizon) 
+you can find these keys in next places:
+
+1. login to "Horizon dashboard" -> "project" -> "Compute" -> "Access & Security" -> tab "API Access" -> "Download OpenStack RC File":
+   * "openstack_auth_url" == OS_AUTH_URL + "/tokens"
+   * "openstack_username" == OS_USERNAME
+   * "openstack_tenant" == OS_TENANT_NAME
+2. "openstack_network": in "project" -> "Networks"
+3. "openstack_keyname": in "project" -> "Compute" -> "Access & Security" -> tab "Key Pairs"
+4. "openstack_api_key": Your user Password
+
+### Setup a Openstack Hosts File
+
+An Openstack hosts file looks like a typical hosts file, 
+except that there are a number of required properties that need to be added to every host 
+in order for the Openstack hypervisor to provision hosts properly.
+
+**Basic Openstack hosts file**
+
     HOSTS:
       centos-6-master:
         roles:
@@ -11,16 +44,57 @@ Considered **EXPERIMENTAL**, may break without notice.
           - database
           - dashboard
         platform: el-6-x86_64
+        hypervisor: openstack
         image: centos-6-x86_64-nocm
         flavor: m1.large
-        hypervisor: openstack
-      centos-6-agent:
+        
+    CONFIG:
+      nfs_server: none
+      consoleport: 443
+      openstack_api_key: Pas$w0rd
+      openstack_username: user
+      openstack_auth_url: http://10.10.10.10:5000/v2.0/tokens
+      openstack_tenant: testing
+      openstack_network : testing
+      openstack_keyname : nopass
+
+The `image` - image name.
+
+The `flavor` - templates for VMs, defining sizes for RAM, disk, number of cores, and so on.
+
+
+# Openstack-Specific Hosts File Settings
+
+### user-data
+
+"user data" - a blob of data that the user can specify when they launch an instance. 
+The instance can access this data through the metadata service or config drive with one of the next requests:
+
+- curl http://169.254.169.254/2009-04-04/user-data
+- curl http://169.254.169.254/openstack/2012-08-10/user_data
+
+
+Examples of `user_data` you can find here: http://cloudinit.readthedocs.io/en/latest/topics/examples.html
+
+Also if you plan use `user-data` make sure that 'cloud-init' package installed in your VM `image` and 'cloud-init' service is running.
+
+**Example Openstack hosts file with user_data**
+
+    HOSTS:
+      centos-6-master:
         roles:
+          - master
           - agent
+          - database
+          - dashboard
         platform: el-6-x86_64
         image: centos-6-x86_64-nocm
         flavor: m1.large
         hypervisor: openstack
+        user_data: |
+          #cloud-config
+          bootcmd:
+            - echo 123 > /tmp/test.txt
     CONFIG:
       nfs_server: none
       consoleport: 443
@@ -30,3 +104,5 @@ Considered **EXPERIMENTAL**, may break without notice.
       openstack_tenant: testing
       openstack_network : testing
       openstack_keyname : nopass
+
+