kitchen-ansible 0.45.4 → 0.45.5

data/provisioner_options.md

@@ -1,126 +1,129 @@
-# Ansible Install Options
-
-Kitchen-ansible is very flexible in how it installs ansible:
-
-It installs it in the following order:
-
-* if require_ansible_omnibus is set to true
-
-  Installs using the omnibus_ansible script specified in the ansible_omnibus_url parameter and passes the ansible_version if specied as -v option.
-
-* If require_ansible_source is set to true
-
-  Install require packages and download the ansible source from github from  master or from a branch specified in the parameter install_source_rev.
-
-* if require_pip is set to true
-
-  Install require packages and then installs ansible using the python pip command and ansible version must be specified. This allows a specific version of ansible to be installed.
-
-* if require_ansible_repo is set to true (the default)
-
-  Installs from the operation system repository only with the ansible version that is in the particular repository and will use the ansible_version in the package name where appropriate.
-
-# Provisioner Options
-
-kitchen-ansible runs the ansible playbook command http://linux.die.net/man/1/ansible-playbook with options from parameters in the kitchen.yml file:
-
-key | default value | Notes
-----|---------------|--------
-additional_copy_path | | Arbitrary array of files and directories to copy into test environment, relative to the current dir, e.g. vars or included playbooks
-additional_copy_role_path | false | additional_copy_path directories are appended to the ANSIBLE_ROLES_PATH env var when running ansible
-ansible_apt_repo | ppa:ansible/ansible | `apt` repo; see `https://launchpad.net` `/~ansible/+archive/ubuntu/ansible` or `rquillo/ansible`
-ansible_binary_path | NULL | If specified this will override the location where `kitchen` tries to run `ansible-playbook` from, i.e. `ansible_binary_path: /usr/local/bin`
-ansible_check | false | Sets the `--check` flag when running Ansible
-ansible_connection | local | use `ssh` if the host is not `localhost` (Linux) or `winrm` (Windows) or `none` if defined in inventory
-ansible_diff | false | Sets the `--diff` flag when running Ansible
-ansible_extra_flags |  | Additional options to pass to ansible-playbook, e.g. `'--skip-tags=redis'`
-ansible_host_key_checking | true | Strict host key checking in ssh
-ansible_inventory |  | Static or dynamic inventory file or directory or 'none' if defined in `ansible.cfg`
-ansible_limit |  | Further limits the selected host/group patterns
-ansible_omnibus_remote_path | /opt/ansible | Server installation location of an Omnibus Ansible install
-ansible_omnibus_url | `https://raw.githubusercontent.com` `/neillturner/omnibus-ansible` `/master/ansible_install.sh` | Omnibus Ansible install location
-ansible_platform | Naively tries to determine | OS platform of server
-ansible_playbook_command | | Override the Ansible playbook command
-ansible_sles_repo | `http://download.opensuse.org/repositories` `/systemsmanagement/SLE_12` `/systemsmanagement.repo` | Zypper SuSE Ansible repo
-ansible_source_rev | | Branch or tag to install Ansible source
-ansible_sudo | true | Determines whether `ansible-playbook` is executed as root or as the current authenticated user
-ansible_vault_password_file | | Path to Ansible Vault password file
-ansible_verbose | false | Extra information logging
-ansible_verbosity | 1 | Sets the verbosity flag appropriately, e.g.: `1 => '-v', 2 => '-vv', 3 => '-vvv' ...`. Valid values are: `1, 2, 3, 4` or `:info, :warn, :debug, :trace`
-ansible_version | latest | Desired version, only affects `apt-get` installs
-ansible_yum_repo | nil | `yum` repo for EL platforms
-ansiblefile_path | | Path to Ansiblefile
-callback_plugins_path | callback_plugins | Ansible repo `callback_plugins` directory
-chef_bootstrap_url | `https://www.getchef.com/chef/install.sh` | The Chef install
-enable_yum_epel | false | Enable the `yum` EPEL repo
-env_vars | Hash.new | Hash to set environment variable to use with `ansible-playbook` command
-extra_vars | Hash.new | Hash to set the `extra_vars` passed to `ansible-playbook` command
-filter_plugins_path | filter_plugins | Ansible repo `filter_plugins` directory
-group_vars_path | group_vars | Ansible repo group_vars directory
-host_vars_path | host_vars | Ansible repo hosts directory
-hosts |  | Create Ansible hosts file for localhost with this server group
-http_proxy | nil | Use HTTP proxy when installing Ansible, packages and running Ansible
-https_proxy | nil | Use HTTPS proxy when installing Ansible, packages and running Ansible
-idempotency_test | false | Enable to test Ansible playbook idempotency
-ignore_paths_from_root | [] | allow extra paths to be ignored when copying from roles and ansible cfg
-kerberos_conf_file | | Path of krb5.conf file using in Windows support
-library_plugins_path | library | Ansible repo library plugins directory
-lookup_plugins_path | lookup_plugins | Ansible repo `lookup_plugins` directory
-modules_path | | Ansible repo manifests directory
-no_proxy | nil | List of URLs or IPs that should be excluded from proxying
-playbook | default.yml | Playbook for `ansible-playbook` to run
-private_key | | ssh private key file for ssh connection
-python_sles_repo | `http://download.opensuse.org/repositories` `/devel:/languages:/python/SLE_12` `/devel:languages:python.repo` | Zypper SuSE python repo
-recursive_additional_copy_path | | Arbitrary array of files and directories to copy into test environment, relative to the current dir, e.g. vars or included playbooks
-require_ansible_omnibus | false | Set to `true` if using Omnibus Ansible `pip` install
-require_ansible_repo | true | Set if installing Ansible from a `yum` or `apt` repo
-require_ansible_source | false | Install Ansible from source using method described [here](http://docs.ansible.com/intro_installation.html#running-from-source). Only works on Debian/Ubuntu at present
-require_chef_for_busser | true | Install Chef to run Busser for tests. NOTE: kitchen 1.4 only requires Ruby to run Busser so this is not required.
-require_pip | false | Set to `true` if Ansible is to be installed through `pip`).
-require_ruby_for_busser | false | Install Ruby to run Busser for tests
-require_windows_support | false | Install [Windows support](http://docs.ansible.com/ansible/intro_windows.html)
-requirements_path | | Path to Ansible Galaxy requirements
-role_name | | use when the repo name does not match the name the role is published as.
-roles_path | roles | Ansible repo roles directory
-ssh_known_hosts | | List of hosts that should be added to ~/.ssh/known_hosts
-sudo_command | sudo -E | `sudo` command; change to `sudo -E -H` to be consistent with Ansible
-update_package_repos | true | Update OS repository metadata
-
-## Configuring Provisioner Options
-
-The provisioner can be configured globally or per suite, global settings act as defaults for all suites, you can then customise per suite, for example:
-
-```yaml
----
-driver:
-  name: vagrant
-
-provisioner:
-  name: ansible_playbook
-  roles_path: roles
-  hosts: tomcat-servers
-  require_ansible_repo: true
-  ansible_verbose: true
-  ansible_verbosity: 2
-  ansible_diff: true
-
-platforms:
-- name: nocm_ubuntu-12.04
-  driver_plugin: vagrant
-  driver_config:
-    box: nocm_ubuntu-12.04
-    box_url: http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-server-12042-x64-vbox4210-nocm.box
-
-suites:
- - name: default
-```
-
-### Per-suite Structure
-
-It can be beneficial to keep different Ansible layouts for different suites. Rather than having to specify the roles, modules, etc for each suite, you can create the following directory structure and they will automatically be found:
-
-```
-$kitchen_root/ansible/$suite_name/roles
-$kitchen_root/ansible/$suite_name/modules
-$kitchen_root/ansible/$suite_name/Ansiblefile
-```
+# Ansible Install Options
+
+Kitchen-ansible is very flexible in how it installs ansible:
+
+It installs it in the following order:
+
+* if require_ansible_omnibus is set to true
+
+  Installs using the omnibus_ansible script specified in the ansible_omnibus_url parameter and passes the ansible_version if specied as -v option.
+
+* If require_ansible_source is set to true
+
+  Install require packages and download the ansible source from github from  master or from a branch specified in the parameter install_source_rev.
+
+* if require_pip is set to true
+
+  Install require packages and then installs ansible using the python pip command and ansible version must be specified. This allows a specific version of ansible to be installed.
+
+* if require_ansible_repo is set to true (the default)
+
+  Installs from the operation system repository only with the ansible version that is in the particular repository and will use the ansible_version in the package name where appropriate.
+
+# Provisioner Options
+
+kitchen-ansible runs the ansible playbook command http://linux.die.net/man/1/ansible-playbook with options from parameters in the kitchen.yml file:
+
+key | default value | Notes
+----|---------------|--------
+additional_copy_path | | Arbitrary array of files and directories to copy into test environment, relative to the current dir, e.g. vars or included playbooks
+additional_copy_role_path | false | additional_copy_path directories are appended to the ANSIBLE_ROLES_PATH env var when running ansible
+ansible_apt_repo | ppa:ansible/ansible | `apt` repo; see `https://launchpad.net` `/~ansible/+archive/ubuntu/ansible` or `rquillo/ansible`
+ansible_binary_path | NULL | If specified this will override the location where `kitchen` tries to run `ansible-playbook` from, i.e. `ansible_binary_path: /usr/local/bin`
+ansible_check | false | Sets the `--check` flag when running Ansible
+ansible_connection | local | use `ssh` if the host is not `localhost` (Linux) or `winrm` (Windows) or `none` if defined in inventory
+ansible_cfg_path | ansible.cfg | location of custom ansible.cfg to get copied into test environment
+ansible_diff | false | Sets the `--diff` flag when running Ansible
+ansible_extra_flags |  | Additional options to pass to ansible-playbook, e.g. `'--skip-tags=redis'`
+ansible_host_key_checking | true | Strict host key checking in ssh
+ansible_inventory |  | Static or dynamic inventory file or directory or 'none' if defined in `ansible.cfg`
+ansible_limit |  | Further limits the selected host/group patterns
+ansible_omnibus_remote_path | /opt/ansible | Server installation location of an Omnibus Ansible install
+ansible_omnibus_url | `https://raw.githubusercontent.com` `/neillturner/omnibus-ansible` `/master/ansible_install.sh` | Omnibus Ansible install location
+ansible_platform | Naively tries to determine | OS platform of server
+ansible_playbook_command | | Override the Ansible playbook command
+ansible_sles_repo | `http://download.opensuse.org/repositories` `/systemsmanagement/SLE_12` `/systemsmanagement.repo` | Zypper SuSE Ansible repo
+ansible_source_rev | | Branch or tag to install Ansible source
+ansible_sudo | true | Determines whether `ansible-playbook` is executed as root or as the current authenticated user
+ansible_vault_password_file | | Path to Ansible Vault password file
+ansible_verbose | false | Extra information logging
+ansible_verbosity | 1 | Sets the verbosity flag appropriately, e.g.: `1 => '-v', 2 => '-vv', 3 => '-vvv' ...`. Valid values are: `1, 2, 3, 4` or `:info, :warn, :debug, :trace`
+ansible_version | latest | Desired version, only affects `apt-get` installs
+ansible_yum_repo | nil | `yum` repo for EL platforms
+ansiblefile_path | | Path to Ansiblefile
+callback_plugins_path | callback_plugins | Ansible repo `callback_plugins` directory
+chef_bootstrap_url | `https://www.getchef.com/chef/install.sh` | The Chef install
+enable_yum_epel | false | Enable the `yum` EPEL repo
+env_vars | Hash.new | Hash to set environment variable to use with `ansible-playbook` command
+extra_vars | Hash.new | Hash to set the `extra_vars` passed to `ansible-playbook` command
+filter_plugins_path | filter_plugins | Ansible repo `filter_plugins` directory
+group_vars_path | group_vars | Ansible repo group_vars directory
+host_vars_path | host_vars | Ansible repo hosts directory
+hosts |  | Create Ansible hosts file for localhost with this server group
+http_proxy | nil | Use HTTP proxy when installing Ansible, packages and running Ansible
+https_proxy | nil | Use HTTPS proxy when installing Ansible, packages and running Ansible
+idempotency_test | false | Enable to test Ansible playbook idempotency
+ignore_extensions_from_root | ['.pyc'] | allow extensions to be ignored when copying from roles and recursive_additional_copy_path
+ignore_paths_from_root | [] | allow extra paths to be ignored when copying from roles and recursive_additional_copy_path
+kerberos_conf_file | | Path of krb5.conf file using in Windows support
+library_plugins_path | library | Ansible repo library plugins directory
+lookup_plugins_path | lookup_plugins | Ansible repo `lookup_plugins` directory
+modules_path | | Ansible repo manifests directory
+no_proxy | nil | List of URLs or IPs that should be excluded from proxying
+playbook | default.yml | Playbook for `ansible-playbook` to run
+private_key | | ssh private key file for ssh connection
+python_sles_repo | `http://download.opensuse.org/repositories` `/devel:/languages:/python/SLE_12` `/devel:languages:python.repo` | Zypper SuSE python repo
+recursive_additional_copy_path | | Arbitrary array of files and directories to copy into test environment, relative to the current dir, e.g. vars or included playbooks
+require_ansible_omnibus | false | Set to `true` if using Omnibus Ansible `pip` install
+require_ansible_repo | true | Set if installing Ansible from a `yum` or `apt` repo
+require_ansible_source | false | Install Ansible from source using method described [here](http://docs.ansible.com/intro_installation.html#running-from-source). Only works on Debian/Ubuntu at present
+require_chef_for_busser | true | Install Chef to run Busser for tests. NOTE: kitchen 1.4 only requires Ruby to run Busser so this is not required.
+require_pip | false | Set to `true` if Ansible is to be installed through `pip`).
+require_ruby_for_busser | false | Install Ruby to run Busser for tests
+require_windows_support | false | Install [Windows support](http://docs.ansible.com/ansible/intro_windows.html)
+requirements_path | | Path to Ansible Galaxy requirements
+role_name | | use when the repo name does not match the name the role is published as.
+roles_path | roles | Ansible repo roles directory
+shell_command | 'sh' | Shell command to use, usually an alias for bash. may need to set to bash.
+ssh_known_hosts | | List of hosts that should be added to ~/.ssh/known_hosts
+sudo_command | sudo -E | `sudo` command; change to `sudo -E -H` to be consistent with Ansible
+update_package_repos | true | Update OS repository metadata
+
+## Configuring Provisioner Options
+
+The provisioner can be configured globally or per suite, global settings act as defaults for all suites, you can then customise per suite, for example:
+
+```yaml
+---
+driver:
+  name: vagrant
+
+provisioner:
+  name: ansible_playbook
+  roles_path: roles
+  hosts: tomcat-servers
+  require_ansible_repo: true
+  ansible_verbose: true
+  ansible_verbosity: 2
+  ansible_diff: true
+
+platforms:
+- name: nocm_ubuntu-12.04
+  driver_plugin: vagrant
+  driver_config:
+    box: nocm_ubuntu-12.04
+    box_url: http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-server-12042-x64-vbox4210-nocm.box
+
+suites:
+ - name: default
+```
+
+### Per-suite Structure
+
+It can be beneficial to keep different Ansible layouts for different suites. Rather than having to specify the roles, modules, etc for each suite, you can create the following directory structure and they will automatically be found:
+
+```
+$kitchen_root/ansible/$suite_name/roles
+$kitchen_root/ansible/$suite_name/modules
+$kitchen_root/ansible/$suite_name/Ansiblefile
+```

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-ansible
 version: !ruby/object:Gem::Version
-  version: 0.45.4
+  version: 0.45.5
 platform: ruby
 authors:
 - Neill Turner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-01 00:00:00.000000000 Z
+date: 2016-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-kitchen
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   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: pry
   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: 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: net-ssh
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
 description: |+
@@ -101,7 +101,9 @@ files:
 - lib/kitchen/provisioner/ansible/config.rb
 - lib/kitchen/provisioner/ansible/librarian.rb
 - lib/kitchen/provisioner/ansible/os.rb
+- lib/kitchen/provisioner/ansible/os/alpine.rb
 - lib/kitchen/provisioner/ansible/os/amazon.rb
+- lib/kitchen/provisioner/ansible/os/darwin.rb
 - lib/kitchen/provisioner/ansible/os/debian.rb
 - lib/kitchen/provisioner/ansible/os/fedora.rb
 - lib/kitchen/provisioner/ansible/os/redhat.rb
@@ -118,17 +120,17 @@ 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: '[none]'
-rubygems_version: 2.0.14.1
+rubyforge_project: "[none]"
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: ansible provisioner for test-kitchen