A Test Kitchen Provisioner for Salt
The provider works by generating a salt-minion config, creating pillars based on attributes in .kitchen.yml & calling salt-call.
This provider has been tested against the Ubuntu boxes running in vagrant/virtualbox & vagrant-lxc boxes on Ubuntu.
You'll need the test-kitchen & kitchen-salt gem's installed in your system, along with kitchen-vagrant or some ther suitable driver for test-kitchen. Please see the INTRODUCTION.
More details on all the configuration optins are in provisioner_options.md
Catching salt failures is particularly troublesome, as salt & salt-call don't do a very good job of setting the exit
code to something useful, around ~0.17.5, the --retcode-passthrough
option was added, but even in 2014.1.0 this is
still flawed, PR11337 should help fix some of those problems. In the
mean time, we scan the salt-call output for signs of failure (essentially grep -e Result.*False -e Data.failed.to.compile -e No.matching.sls.found.for
) and check for a
non-zero exit code from salt-call.
You'll need a driver box that is supported by both the SaltStack bootstrap system & the Chef Omnibus installer (the Chef Omnibus installer is only needed to provide busser with a useable ruby environment, you can tell busser to use an alternative ruby if your box has suitable ruby support built in).
PR's and other changes should validated using Travis-CI and the test-kitchen branch of beaver-formula, this uses the kitchen-ec2 driver, the version of kitchen-salt under review & the latest release of test-kitchen.
TODO: Guide on running the tests locally with test-kitchen, vagrant & virtualbox.
TODO: Guide on running the tests locally with test-kitchen & kitchen-ec2.
# hack. work. test.
git add stuff
git commit -v
gem bump --release --tag