This is a Ruby gem that implements an Ansible Config Parser for Serverspec. It creates a Rake task that can run tests, using Ansible inventory files and playbooks. You can test multiple roles and multiple hosts.
ansible_ssh_port
or ansible_port
ansible_ssh_user
or ansible_user
ansible_ssh_host
or ansible_host
ansible_ssh_private_key_file
www[01:50].example.com
$ gem install ansible_spec
Rakefile
& spec/spec_helper.rb
$ ansiblespec-init
create spec
create spec/spec_helper.rb
create Rakefile
create .ansiblespec
create .rspec
.ansiblespec
By default, site.yml
will be used as the playbook and hosts
as the
inventory file. You can either follow these conventions or you can
customize the playbook and inventory using an .ansiblespec
file.
---
-
playbook: site.yml
inventory: hosts
vars_dirs_path: inventories/staging
hash_behaviour: merge
You can use environment variables with the rake
command. They are listed below.
PLAYBOOK
-- playbook name (e.g. site.yml
)INVENTORY
-- inventory file name (e.g. hosts
)VARS_DIRS_PATH
-- directory path containing the group_vars and host_vars directories (e.g. inventories/staging
)HASH_BEHAVIOUR
-- hash behaviour when duplicate hash variables (e.g. merge
)SSH_CONFIG_FILE
-- ssh configuration file path (e.g. ssh_config
)SSH_CONFIG_FILE
take precedence over the path at ssh_args( -F "filename") in [ssh_connection] section of ansible.cfgEnvironment variables take precedence over the .ansiblespec
file.
Example:
$ PLAYBOOK=site.yml INVENTORY=hosts rake serverspec:Ansible-Sample-TDD
or
$ PLAYBOOK=site.yml rake serverspec:Ansible-Sample-TDD
or
$ INVENTORY=hosts rake serverspec:Ansible-Sample-TDD
or
$ VARS_DIRS_PATH=inventories/staging rake serverspec:Ansible-Sample-TDD
or
$ HASH_BEHAVIOUR=merge rake serverspec:Ansible-Sample-TDD
HASH_BEHAVIOUR is same as Ansible's hash behaviour parameter. By default, 'replace'. See http://docs.ansible.com/ansible/intro_configuration.html#hash-behaviour.
Inventory files can:
ansible_ssh_port
or ansible_port
ansible_ssh_user
or ansible_user
ansible_ssh_host
or ansible_host
ansible_ssh_private_key_file
host-[1:3]
would expand into host-1
,host-2
,host-3
[server]
# skip line(comment)
# normal
192.168.0.1
# use port 5309
192.168.0.3:5309
# use port 22
192.168.0.2 ansible_ssh_port=22
# use Private-key ~/.ssh/id_rsa
192.168.0.4 ansible_ssh_private_key_file=~/.ssh/id_rsa
# use user `git`
192.168.0.5 ansible_ssh_user=git
# use port 5555 & host 192.168.1.50
jumper ansible_ssh_port=5555 ansible_ssh_host=192.168.1.50
# Ansible 2.0
192.168.10.2 ansible_port=2222
192.168.10.5 ansible_user=git
jumper2 ansible_port=5555 ansible_host=192.168.10.50
[web]
# www1.example.com to www99.example.com
www[1:99].example.com
# www01.example.com to www99.example.com
www[01:99].example.com
[databases]
# db-a.example.com to db-z.example.com
db-[a:z].example.com
# db-A.example.com to db-Z.example.com
db-[A:Z].example.com
# Multi Group. use server & databases
[parent:children]
server
databases
(Note: These files need to have execute permission)
#!/bin/bash
echo '{"databases": {"hosts": ["host1.example.com", "host2.example.com"],"vars":{"a": true}}}'
Ansible variables supported by following condition.
Support variables are in site.yml, group_vars, host_vars, roles.
├── site.yml
├── group_vars
│ ├── all.yml
│ ├── dbserver.yml
│ └── webserver.yml
├── host_vars
│ ├── 192.168.1.1.yml
│ └── 192.168.1.2.yml
└── roles
├── apaches
│ └── vars
│ └── main.yml
└── mariadb
└── vars
└── main.yml
and (e.g. when vars_dirs_path: inventories/staging
)
├── site.yml
├── inventories
│ ├── development
| | ├── group_vars
| | │ ├── all.yml
| | │ ├── dbserver.yml
| | │ └── webserver.yml
| | └── host_vars
| | ├── 192.168.1.1.yml
| | └── 192.168.1.2.yml
│ ├── production
| | ├── group_vars
| | │ ├── all.yml
| | │ ├── dbserver.yml
| | │ └── webserver.yml
| | └── host_vars
| | ├── 192.168.10.1.yml
| | └── 192.168.10.2.yml
│ └── staging
| ├── group_vars
| │ ├── all.yml
| │ ├── dbserver.yml
| │ └── webserver.yml
| └── host_vars
| ├── 192.168.20.1.yml
| └── 192.168.20.2.yml
└── roles
├── apaches
│ └── vars
│ └── main.yml
└── mariadb
└── vars
└── main.yml
Note: Parse role dirs from ansible.cfg. This allows us to find specs that are not under ./roles.
# ansible.cfg
[defaults]
roles_path = moreroles
- name: Ansible-Variable-Sample
hosts: webserver.yml
user: root
vars:
- www_port: 8080
roles:
- nginx
describe port(property['www_port']) do
it { should be_listening }
end
sample is here
.
├── .ansiblespec # Create file (use Serverspec). read above section.
├── .rspec # Create file (use Serverspec). read RSpec Doc.
├── README.md
├── hosts # use Ansible and Serverspec if .ansiblespec is not exist.
├── site.yml # use Ansible and Serverspec if .ansiblespec is not exist.
├── nginx.yml # (comment-out) incluted by site.yml
├── roles
│ └── nginx
│ ├── handlers
│ │ └── main.yml
│ ├── spec # use Serverspec
│ │ └── nginx_spec.rb
│ ├── tasks
│ │ └── main.yml
│ ├── templates
│ │ └── nginx.repo
│ └── vars
│ └── main.yml
├── Rakefile # Create file (use Serverspec)
└── spec # Create file (use Serverspec)
└── spec_helper.rb
playbook can use import_playbook
& include[DEPRECATION]
- name: Ansible-Sample-TDD
hosts: server
user: root
roles:
- nginx
- name: Ansible-Sample-TDD2
hosts: parent
user: root
roles:
- nginx
$ rake -T
rake serverspec:Ansible-Sample-TDD # Run serverspec for Ansible-Sample-TDD
rake serverspec:Ansible-Sample-TDD2 # Run serverspec for Ansible-Sample-TDD2
$ rake serverspec:Ansible-Sample-TDD
Run serverspec for Ansible-Sample-TDD to 192.168.0.103
/Users/Adr/.rvm/rubies/ruby-1.9.3-p194/bin/ruby -S rspec roles/mariadb/spec/mariadb_spec.rb roles/nginx/spec/nginx_spec.rb
...........
Finished in 0.34306 seconds
11 examples, 0 failures
To set up a development environment:
$ bundle install
To run the tests:
$ bundle exec rspec
To contribute your change, create a GitHub pull request as follows:
git checkout -b my-new-feature
)git commit -am 'Add some feature'
)git push origin my-new-feature
)