Scroll to navigation

KITCHEN(1) User Commands KITCHEN(1)

NAME

Kitchen - integration tool for Chef

DESCRIPTION

Test Kitchen is a test harness tool to execute your configured code on one or more platforms in isolation. A driver plugin architecture is used which lets you run your code on various cloud providers and virtualization technologies such as Amazon EC2, Blue Box, CloudStack, Digital Ocean, Rackspace, OpenStack, Vagrant, Docker, LXC containers, and more. Many testing frameworks are already supported out of the box including Bats, shUnit2, RSpec, Serverspec, with others being created weekly.

For Chef workflows, cookbook dependency resolver tools such as Berkshelf and Librarian-Chef are supported or you can simply have a cookbooks/ directory and Test Kitchen will know what to do. Support for Test Kitchen is already included in many Chef community cookbooks such as the MySQL, nginx, Chef Server, and runit cookbooks.

Commands:

# Kitchen Console!
# Change instance state to converge. Use a provisioner to configure one or more instances
# Change instance state to create. Start one or more instances
# Change instance state to destroy. Delete all information for one or more instances
# Show computed diagnostic configuration
# Driver subcommands
# Create a new Kitchen Driver gem project
# Discover Test Kitchen drivers published on RubyGems
# Describe subcommands or one specific subcommand
# Execute command on one or more instance
# Describe available commands or one specific command
# Adds some configuration to your cookbook so Kitchen can rock

A `.kitchen.yml` 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.

# Lists one or more instances
# Log in to one instance
# Change instance state to setup. Prepare to run automated tests. Install busser and related gems on one o...
# Test (destroy, create, converge, setup, verify and destroy) one or more instances
# Change instance state to verify. Run automated tests on one or more instances
# Print Kitchen's version information
June 2015 Test Kitchen version 1.4.1