• Stars
    star
    218
  • Rank 181,805 (Top 4 %)
  • Language
    Ruby
  • License
    Other
  • Created over 11 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A Test Kitchen Driver for Amazon EC2

kitchen-ec2

Gem Version CI

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

  1. Install Chef Workstation. If testing things other than Chef Infra cookbooks, please consult your driver's documentation for information on what to install.

  2. Install the AWS command line tools.

  3. Run aws configure. This will set up your AWS credentials for both the AWS CLI tools and kitchen-ec2.

  4. Add or edit the driver section of your kitchen.yml:

    driver:
      name: ec2
  5. 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

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:

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

Apache 2.0 (see LICENSE)

More Repositories

1

test-kitchen

Test Kitchen is an integration tool for developing and testing infrastructure code and software on isolated target platforms
Ruby
1,845
star
2

kitchen-docker

A Test Kitchen Driver for Docker
Ruby
464
star
3

kitchen-vagrant

A Test Kitchen Driver for Vagrant
Ruby
343
star
4

kitchen-dokken

Test Kitchen driver/provisioner for lightning faster Chef Infra cookbook testing with Docker
Ruby
186
star
5

kitchen-digitalocean

A Test Kitchen driver for DigitalOcean
Ruby
74
star
6

kitchen-openstack

OpenStack Compute driver for Test-Kitchen
Ruby
56
star
7

busser-serverspec

A Busser runner plugin for the serverspec testing library
Ruby
54
star
8

kitchen-azurerm

A driver for Test Kitchen that works with Azure Resource Manager
Ruby
49
star
9

kitchen-google

Google Compute Engine driver for Test-Kitchen
Ruby
47
star
10

busser

Kitchen Busser - Runs tests for projects in test-kitchen
Ruby
46
star
11

guard-kitchen

A Guard plugin for Kitchen
Ruby
40
star
12

kitchen-docs

DEPRECATED Test Kitchen Documentation (see test-kitchen)
Ruby
40
star
13

kitchen-pester

A Test Kitchen driver to execute Pester as a verifier
Ruby
28
star
14

kitchen-dsc

A DSC Provisioner for Test-Kitchen
Ruby
27
star
15

dokken-images

Minimal Docker Images for testing
Dockerfile
24
star
16

busser-bats

A Busser runner plugin for bats
Ruby
19
star
17

vmware-vra-gem

A Ruby Gem for interacting with the VMware vRealize Automation system
Ruby
16
star
18

kitchen-habitat

A Test Kitchen Driver for Habitat
Ruby
13
star
19

kitchen-rackspace

A Rackspace Cloud driver for Test Kitchen
Ruby
12
star
20

kitchen-vra

A Test Kitchen driver for VMware vRealize Automation
Ruby
12
star
21

busser-rspec

Run RSpec tests through busser
Ruby
11
star
22

kitchen-cloudstack

CloudStack driver for Test Kitchen
Ruby
11
star
23

busser-minitest

A Busser runner plugin for the minitest testing library
Ruby
9
star
24

winrm-transport

WinRM transport logic for re-using remote shells and uploading files
Ruby
8
star
25

busser-bash

A Busser runner plugin for Bash
Ruby
7
star
26

busser-cucumber

A Busser runner plugin for Cucumber
Ruby
6
star
27

kitchen-joyent

EOL: Joyent Cloud Plugin for Test Kitchen
Ruby
6
star
28

kitchen-vro

A Test Kitchen driver for VMware vRealize Orchestrator
Ruby
5
star
29

kitchen-opennebula

OpenNebula driver for Test Kitchen
Ruby
5
star
30

guide-started-git-cookbook

DEPRECATED: The running example code in the Test Kitchen Getting Started Guide
Ruby
4
star
31

.github

1
star
32

terraform-github-repository

For managing the Test-Kitchen Github Organisation
HCL
1
star
33

kitchen-vcair

A Test Kitchen driver for vCloud Air
Ruby
1
star