Config Tools are a set of tools to use puppet to configure a set of nodes with complex configuration using a step by step approach. Each step is validated by serverspec tests before going to the next step. If the tests of a step fail, puppet is called again on all the nodes.
You need puppet already installed on all the nodes and on the puppet master. All the nodes must be reachable using ssh from the puppet master without interaction.
On the puppet master, you need to have the following installed:
- make
- python with the jinja2 and yaml modules
- rake
- serverspec
Serverspec tests must be under /etc/serverspec
.
Puppet files are under /etc/puppet
.
The puppet manifests and the YAML file describing the tests must be Jinja2 templates in /etc/puppet/manifest/site.pp.tmpl
, /etc/puppet/manifest/params.pp.tmpl
and /etc/serverspec/arch.yml.tmpl
.
Configuration is centralized in /etc/config-tools/global.yaml
.
To provision the needed files, you can use the provision.sh
script like this:
$ ./provision.sh H.1.2.0 deployment.yml
with a deployment.yml
like this:
module:
git@github.com:enovance/puppet-openstack-cloud
serverspec:
git@github.com:enovance/openstack-serverspec.git
environment:
repository:
git@github.com:enovance/ci-env
name:
env.yml
infrastructure:
git@github.com:enovance/os-ref-arch