A Test Kitchen Driver for when you just want to run Chef on localhost.
I swear, there's a reason this driver exists!
TravisCI has a wonderful OS X build environment and AppVeyor a Windows one. This driver allows you to use either as a test environment--having the platform under test be the one running Test Kitchen, rather than a remote cloud server--all while keeping the same Kitchen settings, behavior, and log output you're used to.
Nothing other than a project you wish to test with Test Kitchen and an understanding that this driver will be running against your local machine. If you write a cookbook that formats a hard drive and run it with this driver, bad things will happen.
This driver attempts to minimize cases of multiple test suites clobbering each
other by never running concurrently, even if the
-c option is passed to Test
Kitchen. But everything is still running on the same machine. Don't define
multiple suites unless they're okay to run, serially, on a single server.
Installation and Setup
Add this line to your project's Gemfile:
...and then execute:
$ bundle install
...or install it yourself as:
$ gem install kitchen-localhost
Just override one of the platforms in your Kitchen config to use this driver. That's it!
--- driver: name: vagrant provisioner: name: chef_zero platforms: - name: ubuntu-14.04 - name: centos-7.0 - name: macosx-10.10 driver: name: localhost suites: - name: default run_list: - recipe[something]
Optionally, you can configure the driver to leave behind Test Kitchen's temp
directories when it does a
--- driver: name: localhost clean_up_on_destroy: false
This can be useful if, for example, you have a CI system that's slow to install gems and you want to have it cache Busser + its plugins.
Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:
- Fork the repo
- Create your feature branch (
git checkout -b my-new-feature)
- Ensure your feature has tests and
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request
- Keep an eye on the PR and ensure the CI build passes
New features that have no tests and changes that cause the CI build to fail will not be merged
Apache 2.0 (see LICENSE)