kitchen-terraform is a set of Test Kitchen plugins for testing Terraform configuration.
kitchen-terraform is packaged as a cryptographically signed Ruby gem which means it can be installed with Bundler.
Once Bundler is installed, add kitchen-terraform to the project's Gemfile:
source "https://rubygems.org/" do
gem "kitchen-terraform", "~> 1.0"
end
Then, use Bundler to install the gems:
bundle install
kitchen-terraform provides three Test Kitchen plugins which must be used together in the Test Kitchen configuration in order to successfully test Terraform configuration:
-
a driver that creates and destroys Terraform state;
-
a provisioner that applies changes to existing Terraform state;
-
a verifier that verifies the state and behaviour of resources in the Terraform state.
Refer to the gem documentation for more information about kitchen-terraform's design and behaviour.
Refer to the Getting Started README for a detailed walkthrough of setting up and using kitchen-terraform.
Refer to the examples directory for example Terraform projects using various Terraform providers.