Skip to content

PLOS/kitchen-salt

 
 

Repository files navigation

kitchen-salt

Gem Version Gem Downloads Build Status Code Climate Test Coverage

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.

Installation & Setup

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.

Provisioner Options

More details on all the configuration optins are in provisioner_options.md

Catching salt failures

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.

Requirements

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).

Continuous Integration & Testing

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.

Releasing

# hack. work. test.
git add stuff
git commit -v
gem bump --release --tag

Packages

No packages published

Languages

  • Ruby 85.0%
  • HTML 7.6%
  • Shell 7.4%