kitchen-ansible 0.45.2 → 0.45.3

Sign up to get free protection for your applications and to get access to all the features.
@@ -1,125 +1,125 @@
1
- # Ansible Install Options
2
-
3
- Kitchen-ansible is very flexible in how it installs ansible:
4
-
5
- It installs it in the following order:
6
-
7
- * if require_ansible_omnibus is set to true
8
-
9
- Installs using the omnibus_ansible script specified in the ansible_omnibus_url parameter and passes the ansible_version if specied as -v option.
10
-
11
- * If require_ansible_source is set to true
12
-
13
- Install require packages and download the ansible source from github from master or from a branch specified in the parameter install_source_rev.
14
-
15
- * if require_pip is set to true
16
-
17
- Install require packages and then installs ansible using the python pip command with ansible version if specified.
18
-
19
- * if require_ansible_repo is set to true (the default)
20
-
21
- Installs from the operation system repository with the ansible version that is in the particular repository and will use the ansible_version in the package name where appropriate.
22
-
23
- # Provisioner Options
24
-
25
- kitchen-ansible runs the ansible playbook command http://linux.die.net/man/1/ansible-playbook with options from parameters in the kitchen.yml file:
26
-
27
- key | default value | Notes
28
- ----|---------------|--------
29
- 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
30
- ansible_apt_repo | ppa:ansible/ansible | `apt` repo; see `https://launchpad.net` `/~ansible/+archive/ubuntu/ansible` or `rquillo/ansible`
31
- 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`
32
- ansible_check | false | Sets the `--check` flag when running Ansible
33
- ansible_connection | local | use `ssh` if the host is not `localhost` (Linux) or `winrm` (Windows) or `none` if defined in inventory
34
- ansible_diff | false | Sets the `--diff` flag when running Ansible
35
- ansible_extra_flags | | Additional options to pass to ansible-playbook, e.g. `'--skip-tags=redis'`
36
- ansible_host_key_checking | true | Strict host key checking in ssh
37
- ansible_inventory | | Static or dynamic inventory file or directory or 'none' if defined in `ansible.cfg`
38
- ansible_limit | | Further limits the selected host/group patterns
39
- ansible_omnibus_remote_path | /opt/ansible | Server installation location of an Omnibus Ansible install
40
- ansible_omnibus_url | `https://raw.githubusercontent.com` `/neillturner/omnibus-ansible` `/master/ansible_install.sh` | Omnibus Ansible install location
41
- ansible_platform | Naively tries to determine | OS platform of server
42
- ansible_playbook_command | | Override the Ansible playbook command
43
- ansible_sles_repo | `http://download.opensuse.org/repositories` `/systemsmanagement/SLE_12` `/systemsmanagement.repo` | Zypper SuSE Ansible repo
44
- ansible_source_rev | | Branch or tag to install Ansible source
45
- ansible_sudo | true | Determines whether `ansible-playbook` is executed as root or as the current authenticated user
46
- ansible_vault_password_file | | Path to Ansible Vault password file
47
- ansible_verbose | false | Extra information logging
48
- 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`
49
- ansible_version | latest | Desired version, only affects `apt-get` installs
50
- ansible_yum_repo | nil | `yum` repo for EL platforms
51
- ansiblefile_path | | Path to Ansiblefile
52
- callback_plugins_path | callback_plugins | Ansible repo `callback_plugins` directory
53
- chef_bootstrap_url | `https://www.getchef.com/chef/install.sh` | The Chef install
54
- enable_yum_epel | false | Enable the `yum` EPEL repo
55
- env_vars | Hash.new | Hash to set environment variable to use with `ansible-playbook` command
56
- extra_vars | Hash.new | Hash to set the `extra_vars` passed to `ansible-playbook` command
57
- filter_plugins_path | filter_plugins | Ansible repo `filter_plugins` directory
58
- group_vars_path | group_vars | Ansible repo group_vars directory
59
- host_vars_path | host_vars | Ansible repo hosts directory
60
- hosts | | Create Ansible hosts file for localhost with this server group
61
- http_proxy | nil | Use HTTP proxy when installing Ansible, packages and running Ansible
62
- https_proxy | nil | Use HTTPS proxy when installing Ansible, packages and running Ansible
63
- idempotency_test | false | Enable to test Ansible playbook idempotency
64
- ignore_paths_from_root | [] | allow extra paths to be ignored when copying from roles and ansible cfg
65
- kerberos_conf_file | | Path of krb5.conf file using in Windows support
66
- library_plugins_path | library | Ansible repo library plugins directory
67
- lookup_plugins_path | lookup_plugins | Ansible repo `lookup_plugins` directory
68
- modules_path | | Ansible repo manifests directory
69
- no_proxy | nil | List of URLs or IPs that should be excluded from proxying
70
- playbook | default.yml | Playbook for `ansible-playbook` to run
71
- private_key | | ssh private key file for ssh connection
72
- python_sles_repo | `http://download.opensuse.org/repositories` `/devel:/languages:/python/SLE_12` `/devel:languages:python.repo` | Zypper SuSE python repo
73
- 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
74
- require_ansible_omnibus | false | Set to `true` if using Omnibus Ansible `pip` install
75
- require_ansible_repo | true | Set if installing Ansible from a `yum` or `apt` repo
76
- 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
77
- 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.
78
- require_pip | false | Set to `true` if Ansible is to be installed through `pip`).
79
- require_ruby_for_busser | false | Install Ruby to run Busser for tests
80
- require_windows_support | false | Install [Windows support](http://docs.ansible.com/ansible/intro_windows.html)
81
- requirements_path | | Path to Ansible Galaxy requirements
82
- role_name | | use when the repo name does not match the name the role is published as.
83
- roles_path | roles | Ansible repo roles directory
84
- ssh_known_hosts | | List of hosts that should be added to ~/.ssh/known_hosts
85
- sudo_command | sudo -E | `sudo` command; change to `sudo -E -H` to be consistent with Ansible
86
- update_package_repos | true | Update OS repository metadata
87
-
88
- ## Configuring Provisioner Options
89
-
90
- 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:
91
-
92
- ```yaml
93
- ---
94
- driver:
95
- name: vagrant
96
-
97
- provisioner:
98
- name: ansible_playbook
99
- roles_path: roles
100
- hosts: tomcat-servers
101
- require_ansible_repo: true
102
- ansible_verbose: true
103
- ansible_verbosity: 2
104
- ansible_diff: true
105
-
106
- platforms:
107
- - name: nocm_ubuntu-12.04
108
- driver_plugin: vagrant
109
- driver_config:
110
- box: nocm_ubuntu-12.04
111
- box_url: http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-server-12042-x64-vbox4210-nocm.box
112
-
113
- suites:
114
- - name: default
115
- ```
116
-
117
- ### Per-suite Structure
118
-
119
- 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:
120
-
121
- ```
122
- $kitchen_root/ansible/$suite_name/roles
123
- $kitchen_root/ansible/$suite_name/modules
124
- $kitchen_root/ansible/$suite_name/Ansiblefile
125
- ```
1
+ # Ansible Install Options
2
+
3
+ Kitchen-ansible is very flexible in how it installs ansible:
4
+
5
+ It installs it in the following order:
6
+
7
+ * if require_ansible_omnibus is set to true
8
+
9
+ Installs using the omnibus_ansible script specified in the ansible_omnibus_url parameter and passes the ansible_version if specied as -v option.
10
+
11
+ * If require_ansible_source is set to true
12
+
13
+ Install require packages and download the ansible source from github from master or from a branch specified in the parameter install_source_rev.
14
+
15
+ * if require_pip is set to true
16
+
17
+ Install require packages and then installs ansible using the python pip command with ansible version if specified.
18
+
19
+ * if require_ansible_repo is set to true (the default)
20
+
21
+ Installs from the operation system repository with the ansible version that is in the particular repository and will use the ansible_version in the package name where appropriate.
22
+
23
+ # Provisioner Options
24
+
25
+ kitchen-ansible runs the ansible playbook command http://linux.die.net/man/1/ansible-playbook with options from parameters in the kitchen.yml file:
26
+
27
+ key | default value | Notes
28
+ ----|---------------|--------
29
+ 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
30
+ ansible_apt_repo | ppa:ansible/ansible | `apt` repo; see `https://launchpad.net` `/~ansible/+archive/ubuntu/ansible` or `rquillo/ansible`
31
+ 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`
32
+ ansible_check | false | Sets the `--check` flag when running Ansible
33
+ ansible_connection | local | use `ssh` if the host is not `localhost` (Linux) or `winrm` (Windows) or `none` if defined in inventory
34
+ ansible_diff | false | Sets the `--diff` flag when running Ansible
35
+ ansible_extra_flags | | Additional options to pass to ansible-playbook, e.g. `'--skip-tags=redis'`
36
+ ansible_host_key_checking | true | Strict host key checking in ssh
37
+ ansible_inventory | | Static or dynamic inventory file or directory or 'none' if defined in `ansible.cfg`
38
+ ansible_limit | | Further limits the selected host/group patterns
39
+ ansible_omnibus_remote_path | /opt/ansible | Server installation location of an Omnibus Ansible install
40
+ ansible_omnibus_url | `https://raw.githubusercontent.com` `/neillturner/omnibus-ansible` `/master/ansible_install.sh` | Omnibus Ansible install location
41
+ ansible_platform | Naively tries to determine | OS platform of server
42
+ ansible_playbook_command | | Override the Ansible playbook command
43
+ ansible_sles_repo | `http://download.opensuse.org/repositories` `/systemsmanagement/SLE_12` `/systemsmanagement.repo` | Zypper SuSE Ansible repo
44
+ ansible_source_rev | | Branch or tag to install Ansible source
45
+ ansible_sudo | true | Determines whether `ansible-playbook` is executed as root or as the current authenticated user
46
+ ansible_vault_password_file | | Path to Ansible Vault password file
47
+ ansible_verbose | false | Extra information logging
48
+ 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`
49
+ ansible_version | latest | Desired version, only affects `apt-get` installs
50
+ ansible_yum_repo | nil | `yum` repo for EL platforms
51
+ ansiblefile_path | | Path to Ansiblefile
52
+ callback_plugins_path | callback_plugins | Ansible repo `callback_plugins` directory
53
+ chef_bootstrap_url | `https://www.getchef.com/chef/install.sh` | The Chef install
54
+ enable_yum_epel | false | Enable the `yum` EPEL repo
55
+ env_vars | Hash.new | Hash to set environment variable to use with `ansible-playbook` command
56
+ extra_vars | Hash.new | Hash to set the `extra_vars` passed to `ansible-playbook` command
57
+ filter_plugins_path | filter_plugins | Ansible repo `filter_plugins` directory
58
+ group_vars_path | group_vars | Ansible repo group_vars directory
59
+ host_vars_path | host_vars | Ansible repo hosts directory
60
+ hosts | | Create Ansible hosts file for localhost with this server group
61
+ http_proxy | nil | Use HTTP proxy when installing Ansible, packages and running Ansible
62
+ https_proxy | nil | Use HTTPS proxy when installing Ansible, packages and running Ansible
63
+ idempotency_test | false | Enable to test Ansible playbook idempotency
64
+ ignore_paths_from_root | [] | allow extra paths to be ignored when copying from roles and ansible cfg
65
+ kerberos_conf_file | | Path of krb5.conf file using in Windows support
66
+ library_plugins_path | library | Ansible repo library plugins directory
67
+ lookup_plugins_path | lookup_plugins | Ansible repo `lookup_plugins` directory
68
+ modules_path | | Ansible repo manifests directory
69
+ no_proxy | nil | List of URLs or IPs that should be excluded from proxying
70
+ playbook | default.yml | Playbook for `ansible-playbook` to run
71
+ private_key | | ssh private key file for ssh connection
72
+ python_sles_repo | `http://download.opensuse.org/repositories` `/devel:/languages:/python/SLE_12` `/devel:languages:python.repo` | Zypper SuSE python repo
73
+ 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
74
+ require_ansible_omnibus | false | Set to `true` if using Omnibus Ansible `pip` install
75
+ require_ansible_repo | true | Set if installing Ansible from a `yum` or `apt` repo
76
+ 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
77
+ 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.
78
+ require_pip | false | Set to `true` if Ansible is to be installed through `pip`).
79
+ require_ruby_for_busser | false | Install Ruby to run Busser for tests
80
+ require_windows_support | false | Install [Windows support](http://docs.ansible.com/ansible/intro_windows.html)
81
+ requirements_path | | Path to Ansible Galaxy requirements
82
+ role_name | | use when the repo name does not match the name the role is published as.
83
+ roles_path | roles | Ansible repo roles directory
84
+ ssh_known_hosts | | List of hosts that should be added to ~/.ssh/known_hosts
85
+ sudo_command | sudo -E | `sudo` command; change to `sudo -E -H` to be consistent with Ansible
86
+ update_package_repos | true | Update OS repository metadata
87
+
88
+ ## Configuring Provisioner Options
89
+
90
+ 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:
91
+
92
+ ```yaml
93
+ ---
94
+ driver:
95
+ name: vagrant
96
+
97
+ provisioner:
98
+ name: ansible_playbook
99
+ roles_path: roles
100
+ hosts: tomcat-servers
101
+ require_ansible_repo: true
102
+ ansible_verbose: true
103
+ ansible_verbosity: 2
104
+ ansible_diff: true
105
+
106
+ platforms:
107
+ - name: nocm_ubuntu-12.04
108
+ driver_plugin: vagrant
109
+ driver_config:
110
+ box: nocm_ubuntu-12.04
111
+ box_url: http://puppet-vagrant-boxes.puppetlabs.com/ubuntu-server-12042-x64-vbox4210-nocm.box
112
+
113
+ suites:
114
+ - name: default
115
+ ```
116
+
117
+ ### Per-suite Structure
118
+
119
+ 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:
120
+
121
+ ```
122
+ $kitchen_root/ansible/$suite_name/roles
123
+ $kitchen_root/ansible/$suite_name/modules
124
+ $kitchen_root/ansible/$suite_name/Ansiblefile
125
+ ```
metadata CHANGED
@@ -1,83 +1,83 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: kitchen-ansible
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.45.2
4
+ version: 0.45.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Neill Turner
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2016-08-07 00:00:00.000000000 Z
11
+ date: 2016-08-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: test-kitchen
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - "~>"
17
+ - - ~>
18
18
  - !ruby/object:Gem::Version
19
19
  version: '1.4'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
- - - "~>"
24
+ - - ~>
25
25
  - !ruby/object:Gem::Version
26
26
  version: '1.4'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: rspec
29
29
  requirement: !ruby/object:Gem::Requirement
30
30
  requirements:
31
- - - ">="
31
+ - - '>='
32
32
  - !ruby/object:Gem::Version
33
33
  version: '0'
34
34
  type: :development
35
35
  prerelease: false
36
36
  version_requirements: !ruby/object:Gem::Requirement
37
37
  requirements:
38
- - - ">="
38
+ - - '>='
39
39
  - !ruby/object:Gem::Version
40
40
  version: '0'
41
41
  - !ruby/object:Gem::Dependency
42
42
  name: pry
43
43
  requirement: !ruby/object:Gem::Requirement
44
44
  requirements:
45
- - - ">="
45
+ - - '>='
46
46
  - !ruby/object:Gem::Version
47
47
  version: '0'
48
48
  type: :development
49
49
  prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
- - - ">="
52
+ - - '>='
53
53
  - !ruby/object:Gem::Version
54
54
  version: '0'
55
55
  - !ruby/object:Gem::Dependency
56
56
  name: rake
57
57
  requirement: !ruby/object:Gem::Requirement
58
58
  requirements:
59
- - - ">="
59
+ - - '>='
60
60
  - !ruby/object:Gem::Version
61
61
  version: '0'
62
62
  type: :development
63
63
  prerelease: false
64
64
  version_requirements: !ruby/object:Gem::Requirement
65
65
  requirements:
66
- - - ">="
66
+ - - '>='
67
67
  - !ruby/object:Gem::Version
68
68
  version: '0'
69
69
  - !ruby/object:Gem::Dependency
70
70
  name: net-ssh
71
71
  requirement: !ruby/object:Gem::Requirement
72
72
  requirements:
73
- - - "~>"
73
+ - - ~>
74
74
  - !ruby/object:Gem::Version
75
75
  version: '3.0'
76
76
  type: :runtime
77
77
  prerelease: false
78
78
  version_requirements: !ruby/object:Gem::Requirement
79
79
  requirements:
80
- - - "~>"
80
+ - - ~>
81
81
  - !ruby/object:Gem::Version
82
82
  version: '3.0'
83
83
  description: |+
@@ -118,17 +118,17 @@ require_paths:
118
118
  - lib
119
119
  required_ruby_version: !ruby/object:Gem::Requirement
120
120
  requirements:
121
- - - ">="
121
+ - - '>='
122
122
  - !ruby/object:Gem::Version
123
123
  version: '0'
124
124
  required_rubygems_version: !ruby/object:Gem::Requirement
125
125
  requirements:
126
- - - ">="
126
+ - - '>='
127
127
  - !ruby/object:Gem::Version
128
128
  version: '0'
129
129
  requirements: []
130
- rubyforge_project: "[none]"
131
- rubygems_version: 2.2.2
130
+ rubyforge_project: '[none]'
131
+ rubygems_version: 2.0.14.1
132
132
  signing_key:
133
133
  specification_version: 4
134
134
  summary: ansible provisioner for test-kitchen