Website | https://kitchen.ci/ |
Source Code | https://kitchen.ci/docs/getting-started/ |
Slack | #test-kitchen channel on Chef Community Slack |
@kitchenci |
Test Kitchen is an integration tool for developing and testing infrastructure code and software on isolated target platforms.Adds zl-kitchen executable.Code: https://github.com/deeptshukla/test-kitchen
To learn how to install and setup Test Kitchen for developing infrastructure code, check out the Getting Started Guide.
If you want to get going super fast, then try the Quick Start next...
Test Kitchen is a RubyGem and can be installed with:
$ gem install test-kitchen-rsync
If you use Bundler, you can add gem "test-kitchen-rsync"
to your Gemfile and make
sure to run bundle install
.
Next add support to your library, Chef cookbook, or empty project with zl-kitchen init`:
$zl-kitchen init
A kitchen.yml
file will be created in your project base directory. This file
describes your testing configuration; what you want to test and on which target
platforms. Each of these suite and platform combinations are called instances.
By default your instances will be converged with Chef Solo and run in Vagrant
virtual machines.
Get a listing of your instances with:
$ zl-kitchen list
Run Chef Infra Client on an instance, in this case default-ubuntu-2004
, with:
$ zl-kitchen converge default-ubuntu-2004
Destroy all instances with:
$ zl-kitchen destroy
You can clone a Chef Infra cookbook project that contains Test Kitchen support and run through all the instances in serial by running:
$ zl-kitchen test
There is help included with the zl-kitchen help` subcommand which will list all subcommands and their usage:
$ zl-kitchen help test
More verbose logging for test-kitchen-rsync can be specified when running test-kitchen-rsync from the command line using:
$ zl-kitchen test -l debug
For the provisioner (e.g. chef-solo or chef-infra) add a log_level
item to the provisioner section of the .kitchen.yml
For more information on setting log_level
see the configuration documentation.
Documentation is being added on the Test Kitchen website. Please read and contribute to improve them!
Test Kitchen aims to adhere to Semantic Versioning 2.0.0.
If you would like to see a few of the plugins or ecosystem helpers, please look at ECOSYSTEM.md.
- Source hosted at GitHub
- Report issues/questions/feature requests on GitHub Issues
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
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Created by Fletcher Nichol ([email protected]).
Maintained by Chef Software and a growing community of contributors.
Apache License, Version 2.0 (see LICENSE)
Updated the binary from kitchen to zl-kitchen Uses rsync instead of scp Installs the rsync if not available
For using with docker you will need to install kitchen-docker
For using with ec2 you will need to install kitchen-ec2