kitchen-ec2
A Test Kitchen Driver for Amazon EC2.
This driver uses the aws sdk gem to provision and destroy EC2 instances. Use Amazon's cloud for your infrastructure testing!
Quick Start
-
Install Chef Workstation. If testing things other than Chef Infra cookbooks, please consult your driver's documentation for information on what to install.
-
Install the AWS command line tools.
-
Run
aws configure
. This will set up your AWS credentials for both the AWS CLI tools and kitchen-ec2. -
Add or edit the
driver
section of yourkitchen.yml
:driver: name: ec2
-
Run
kitchen test
.
Requirements
There are no external system requirements for this driver. However you
will need access to an AWS account. IAM users should have, at a minimum, permission to manage the lifecycle of an EC2 instance along with modifying components specified in kitchen driver configs. Consider using a permissive managed IAM policy like arn:aws:iam::aws:policy/AmazonEC2FullAccess
or tailor one specific to your security requirements.
Configuration
By automatically applying reasonable defaults wherever possible, kitchen-ec2 does a lot of work to make your life easier. See the kitchen.ci kitchen-ec2 docs for a complete list of configuration options.
Development
- 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 new Pull Request
License
Apache 2.0 (see LICENSE)