kitchen-ec2 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3897a853bbce0fe66db106da6852004cc39e6bc
-  data.tar.gz: 804747d7bf806717e31e4b6ac946497ee3aaf935
+  metadata.gz: b12924746e2f87674fd4988de55bce1d30507be4
+  data.tar.gz: 7fbbd13c4e9810f0aad3d15bff357291cd808695
 SHA512:
-  metadata.gz: eec29c52770a4d005cf1a2769cc131f25cd351591075108ebe745a954b2e6243d30ebdf9cd87848b03321dcca124f80cae0861cec9aa5e193ee36cabf649cdb5
-  data.tar.gz: b53ed98bc1d2419f90b65114fe0db08db33f036d1e222e4dbbef9e791e396e6704492b58ddf1b9da406703a47e845e88f2efacde5cab3fdf7b3717388e7709f7
+  metadata.gz: 67561dd868c1a2e8664f99791b62c237b9dc698ed17d587c0f10ce83ad61713a166742d7b50679d93423acf23f5fbecd55e20eaf8d68f3519106af1ecc5d21b7
+  data.tar.gz: db02d3bd6413b7a35e6a843ebced5eba8e54c939462966aee92b87881907e81ad314c4df6839633b912c3b33ad60777fa6cc9ce44864a729b27aec749eb37745

data/.cane

@@ -1 +1,2 @@
---style-measure 100
+--abc-max 30
+--style-measure 100

data/.gitignore

@@ -15,3 +15,5 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+.project
+

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--format progress

data/.rubocop.yml

@@ -0,0 +1,9 @@
+Style/FileName:
+  Exclude:
+    - 'data/**/*'
+
+Style/Next:
+  Enabled: false
+
+Style/DoubleNegation:
+  Enabled: false

data/.yardopts

@@ -0,0 +1,3 @@
+--readme README.md
+--markup markdown
+--markup-provider maruku

data/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 0.9.0 / 2015-05-18
+
+### Bug Fixes
+
+* Pull Request [#46][]: Don't create multiple instances if `kitchen create` is called multiple times. ([@anl][])
+* Pull Request [#97][], [#69][], [#99][]: Try additional connections to servers which don't have a `public_ip_address`.  This helps connect to nodes over VPN. ([@chuckg][], [@tyler-ball][], [@mumoshu][])
+
+### New Features
+
+* Pull Request [#35][]: Adding support for specifying the IAM profile on created instance.  Set `:iam_profile_name` in the driver section of your .kitchen.yml to specify this. ([@nicgrayson][])
+* Pull Request [#82][]: Add the ability to specify user data.  Set `:user_data` in the driver section of your .kitchen.yml.  This can either be the user data or the path to a file which contains the user data. ([@sebbrandt87][])
+* Pull Request [#84][]: Add the ability to specify the private ip of the instance.  Set `:private_ip_address` in the driver section of your .kitchen.yml. ([@scarolan][])
+* Pull Request [#68][], [#104][], [#107][]: If provisioning from an EC2 host and credentials are not set use the local nodes's credentials.  If access key & secret are set, do not use local session token - leave it unset. ([@JamesAwesome][], [@Igorshp][], [@daanemanz][])
+
+### Improvements
+
+* Pull Request [#110][]: Updating to use the AWS SDK V2 instead of Fog. ([@tyler-ball][])
+    * We no longer recommend storing the AWS credentials in the `.kitchen.yml` file.  Instead, specify them as environment variables or in the `~/.aws/credentials` file.  See the README for more details.
+* Pull Request [#112][]: Updating to depend on the latest version of Test Kitchen, 1.4.0. ([@jmundrawala][])
+
 ## 0.8.0 / 2014-02-11
 
 ### Bug fixes
@@ -61,36 +81,59 @@
 * Remove default_config :port in favor of SSHBase default (also 22). ([@fnichol][])
 
 <!--- The following link definition list is generated by PimpMyChangelog --->
-[#2]: https://github.com/opscode/kitchen-ec2/issues/2
-[#5]: https://github.com/opscode/kitchen-ec2/issues/5
-[#7]: https://github.com/opscode/kitchen-ec2/issues/7
-[#8]: https://github.com/opscode/kitchen-ec2/issues/8
-[#9]: https://github.com/opscode/kitchen-ec2/issues/9
-[#13]: https://github.com/opscode/kitchen-ec2/issues/13
-[#14]: https://github.com/opscode/kitchen-ec2/issues/14
-[#15]: https://github.com/opscode/kitchen-ec2/issues/15
-[#20]: https://github.com/opscode/kitchen-ec2/issues/20
-[#21]: https://github.com/opscode/kitchen-ec2/issues/21
-[#22]: https://github.com/opscode/kitchen-ec2/issues/22
-[#23]: https://github.com/opscode/kitchen-ec2/issues/23
-[#27]: https://github.com/opscode/kitchen-ec2/issues/27
-[#28]: https://github.com/opscode/kitchen-ec2/issues/28
-[#29]: https://github.com/opscode/kitchen-ec2/issues/29
-[#31]: https://github.com/opscode/kitchen-ec2/issues/31
-[#34]: https://github.com/opscode/kitchen-ec2/issues/34
+[#2]: https://github.com/test-kitchen/kitchen-ec2/issues/2
+[#5]: https://github.com/test-kitchen/kitchen-ec2/issues/5
+[#7]: https://github.com/test-kitchen/kitchen-ec2/issues/7
+[#8]: https://github.com/test-kitchen/kitchen-ec2/issues/8
+[#9]: https://github.com/test-kitchen/kitchen-ec2/issues/9
+[#13]: https://github.com/test-kitchen/kitchen-ec2/issues/13
+[#14]: https://github.com/test-kitchen/kitchen-ec2/issues/14
+[#15]: https://github.com/test-kitchen/kitchen-ec2/issues/15
+[#20]: https://github.com/test-kitchen/kitchen-ec2/issues/20
+[#21]: https://github.com/test-kitchen/kitchen-ec2/issues/21
+[#22]: https://github.com/test-kitchen/kitchen-ec2/issues/22
+[#23]: https://github.com/test-kitchen/kitchen-ec2/issues/23
+[#27]: https://github.com/test-kitchen/kitchen-ec2/issues/27
+[#28]: https://github.com/test-kitchen/kitchen-ec2/issues/28
+[#29]: https://github.com/test-kitchen/kitchen-ec2/issues/29
+[#31]: https://github.com/test-kitchen/kitchen-ec2/issues/31
+[#34]: https://github.com/test-kitchen/kitchen-ec2/issues/34
+[#35]: https://github.com/test-kitchen/kitchen-ec2/issues/35
+[#46]: https://github.com/test-kitchen/kitchen-ec2/issues/46
+[#68]: https://github.com/test-kitchen/kitchen-ec2/issues/68
+[#69]: https://github.com/test-kitchen/kitchen-ec2/issues/69
+[#82]: https://github.com/test-kitchen/kitchen-ec2/issues/82
+[#84]: https://github.com/test-kitchen/kitchen-ec2/issues/84
+[#97]: https://github.com/test-kitchen/kitchen-ec2/issues/97
+[#99]: https://github.com/test-kitchen/kitchen-ec2/issues/99
+[#104]: https://github.com/test-kitchen/kitchen-ec2/issues/104
+[#107]: https://github.com/test-kitchen/kitchen-ec2/issues/107
+[#110]: https://github.com/test-kitchen/kitchen-ec2/issues/110
+[#112]: https://github.com/test-kitchen/kitchen-ec2/issues/112
 [@Atalanta]: https://github.com/Atalanta
+[@Igorshp]: https://github.com/Igorshp
+[@JamesAwesome]: https://github.com/JamesAwesome
+[@anl]: https://github.com/anl
 [@arangamani]: https://github.com/arangamani
 [@bozinsky]: https://github.com/bozinsky
+[@chuckg]: https://github.com/chuckg
 [@coderanger]: https://github.com/coderanger
+[@daanemanz]: https://github.com/daanemanz
 [@dissonanz]: https://github.com/dissonanz
 [@dysinger]: https://github.com/dysinger
 [@eherot]: https://github.com/eherot
 [@fnichol]: https://github.com/fnichol
 [@halcyonCorsair]: https://github.com/halcyonCorsair
+[@jmundrawala]: https://github.com/jmundrawala
 [@juliandunn]: https://github.com/juliandunn
 [@matheeeny]: https://github.com/matheeeny
 [@mattray]: https://github.com/mattray
+[@mumoshu]: https://github.com/mumoshu
+[@nicgrayson]: https://github.com/nicgrayson
+[@scarolan]: https://github.com/scarolan
+[@sebbrandt87]: https://github.com/sebbrandt87
 [@sethvargo]: https://github.com/sethvargo
 [@someara]: https://github.com/someara
 [@spheromak]: https://github.com/spheromak
 [@tiwilliam]: https://github.com/tiwilliam
+[@tyler-ball]: https://github.com/tyler-ball

data/Gemfile

@@ -1,9 +1,9 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in kitchen-ec2.gemspec
 gemspec
 
 group :test do
-  gem 'rake'
-  gem 'pry'
+  gem "rake"
+  gem "pry"
 end

data/README.md

@@ -6,19 +6,19 @@
 
 A [Test Kitchen][kitchenci] Driver for Amazon EC2.
 
-This driver uses the [fog gem][fog_gem] to provision and destroy EC2
+This driver uses the [aws sdk gem][aws_sdk_gem] to provision and destroy EC2
 instances. Use Amazon's cloud for your infrastructure testing!
 
-## <a name="requirements"></a> Requirements
+## Requirements
 
 There are **no** external system requirements for this driver. However you
 will need access to an [AWS][aws_site] account.
 
-## <a name="installation"></a> Installation and Setup
+## Installation and Setup
 
 Please read the [Driver usage][driver_usage] page for more details.
 
-## <a name="default-config"></a> Default Configuration
+## Default Configuration
 
 This driver can determine AMI and username login for a select number of
 platforms in each region. Currently, the following platform names are
@@ -31,6 +31,8 @@ platforms:
   - name: ubuntu-12.04
   - name: ubuntu-12.10
   - name: ubuntu-13.04
+  - name: ubuntu-13.10
+  - name: ubuntu-14.04
   - name: centos-6.4
   - name: debian-7.1.0
 ```
@@ -58,63 +60,98 @@ platforms:
 
 For specific default values, please consult [amis.json][amis_json].
 
-## <a name="config"></a> Configuration
+## Authenticating with AWS
 
-### <a name="config-az"></a> availability\_zone
+There are 3 ways you can authenticate against AWS, and we will try them in the
+following order:
 
-**Required** The AWS [availability zone][region_docs] to use.
+1. You can specify the access key and access secret (and optionally the session
+token) through config.  See the `aws_access_key_id` and `aws_secret_access_key`
+config sections below to see how to specify these in your .kitchen.yml or
+through environment variables.  If you would like to specify your session token
+use the environment variable `AWS_SESSION_TOKEN`.
+1. The shared credentials ini file at `~/.aws/credentials`.  You can specify 
+multiple profiles in this file and select one with the `AWS_PROFILE`
+environment variable or the `shared_credentials_profile` driver config.  Read
+[this][credentials_docs] for more information.
+1. From an instance profile when running on EC2.  This accesses the local
+metadata service to discover the local instance's IAM instance profile.
 
-The default is `"us-east-1b"`.
+This precedence order is taken from http://docs.aws.amazon.com/sdkforruby/api/index.html#Configuration
+  
+The first method attempted that works will be used.  IE, if you want to auth
+using the instance profile, you must not set any of the access key configs
+or environment variables, and you must not specify a `~/.aws/credentials`
+file.
 
-### <a name="config-aws-access-key-id"></a> aws\_access\_key\_id
+Because the Test Kitchen test should be checked into source control and ran
+through CI we no longer recommend storing the AWS credentials in the
+`.kitchen.yml` file.  Instead, specify them as environment variables or in the 
+`~/.aws/credentials` file.
 
-**Required** The AWS [access key id][credentials_docs] to use.
+## General Configuration
 
-The default will be read from the `AWS_ACCESS_KEY` environment variable if set,
-or `nil` otherwise.
+### availability\_zone
 
-### <a name="config-aws-secret-access-key"></a> aws\_secret\_access\_key
+The AWS [availability zone][region_docs] to use.  Only request
+the letter designation - will attach this to the region used.
 
-**Required** The AWS [secret access key][credentials_docs] to use.
+The default is `"#{region}b"`.
 
-The default will be read from the `AWS_SECRET_KEY` environment variable if set,
-or `nil` otherwise.
+### aws\_access\_key\_id
+
+**Deprecated** It is recommended to use the `AWS_ACCESS_KEY_ID` or the
+`~/.aws/credentials` file instead.
+
+The AWS [access key id][credentials_docs] to use.
+
+### aws\_secret\_access\_key
+
+**Deprecated** It is recommended to use the `AWS_SECRET_ACCESS_KEY` or the
+`~/.aws/credentials` file instead.
+
+The AWS [secret access key][credentials_docs] to use.
+
+### shared\_credentials\_profile
 
-### <a name="config-aws-ssh-key-id"></a> aws\_ssh\_key\_id
+The EC2 [profile name][credentials_docs] to use when reading credentials out
+of `~/.aws/credentials`.  If it is not specified AWS will read the `Default`
+profile credentials (if using this method of authentication).
+
+Can also be specified as `ENV['AWS_PROFILE']`.
+
+### aws\_ssh\_key\_id
 
 **Required** The EC2 [SSH key id][key_id_docs] to use.
 
 The default will be read from the `AWS_SSH_KEY_ID` environment variable if set,
 or `nil` otherwise.
 
-### endpoint
+### aws\_session\_token
 
-The API endpoint for executing EC2 commands.
+**Deprecated** It is recommended to use the `AWS_SESSION_TOKEN` or the
+`~/.aws/credentials` file instead.
 
-The default will be computed from the AWS region name for the instance.
+The AWS [session token][credentials_docs] to use.
 
-### <a name="config-flavor-id"></a> flavor\_id
+### flavor\_id
 
-The EC2 [instance type][instance_docs] (also known as size) to use.
+**Deprecated** See [instance_type](#config-instance_type) below.
 
-The default is `"m1.small"`.
+### <a name="config-instance_type"></a> instance\_type
 
-### <a name="config-ebs-optimized"></a> ebs\_optimized
-
-Option to launch EC2 instance with optimized EBS volume. See
-[Amazon EC2 Instance Types](http://aws.amazon.com/ec2/instance-types/) to find
-out more about instance types that can be launched as EBS-optimized instances.
+The EC2 [instance type][instance_docs] (also known as size) to use.
 
-The default is `false`.
+The default is `"m1.small"`.
 
-### <a name="config-security-group-ids"></a> security_group_ids
+### security_group_ids
 
 An Array of EC2 [security groups][group_docs] which will be applied to the
 instance.
 
 The default is `["default"]`.
 
-### <a name="config-image-id"></a> image\_id
+### image\_id
 
 **Required** The EC2 [AMI id][ami_docs] to use.
 
@@ -122,13 +159,126 @@ The default will be determined by the `aws_region` chosen and the Platform
 name, if a default exists (see [amis.json][ami_json]). If a default cannot be
 computed, then the default is `nil`.
 
-### <a name="config-port"></a> port
+### region
+
+**Required** The AWS [region][region_docs] to use.
+
+If the environment variable `AWS_REGION` is populated that will be used.
+Otherwise the default is `"us-east-1"`.
+
+### subnet\_id
+
+The EC2 [subnet][subnet_docs] to use.
+
+The default is unset, or `nil`.
+
+### tags
+
+The Hash of EC tag name/value pairs which will be applied to the instance.
+
+The default is `{ "created-by" => "test-kitchen" }`.
+
+### user_data
+
+The user_data script or the path to a script to feed the instance.
+Use bash to install dependencies or download artifacts before chef runs.
+This is just for some cases. If you can do the stuff with chef, then do it with
+chef!
+
+The default is unset, or `nil`.
+
+### iam\_profile\_name
+
+The EC2 IAM profile name to use.
+
+The default is `nil`.
+
+### price
+
+The price you bid in order to submit a spot request. An additional step will be required during the spot request process submission. If no price is set, it will use an on-demand instance.
+
+The default is `nil`.
+
+## Disk Configuration
+
+### ebs\_volume\_size
+
+**Deprecated** See [block_device_mappings](#config-block_device_mappings) below.
 
-The SSH port number to be used when communicating with the instance.
+Size of ebs volume in GB.
 
-The default is `22`.
+### ebs\_delete\_on\_termination
 
-### < name="interface"></a> interface
+**Deprecated** See [block_device_mappings](#config-block_device_mappings) below.
+
+`true` if you want ebs volumes to get deleted automatically after instance is terminated, `false` otherwise
+
+### ebs\_device\_name
+
+**Deprecated** See [block_device_mappings](#config-block_device_mappings) below.
+
+name of your ebs device, for example: `/dev/sda1`
+
+### <a name="config-block_device_mappings"></a> block\_device\_mappings
+
+A list of block device mappings for the machine.  An example of all available keys looks like:
+```yaml
+block_device_mappings:
+  - ebs_device_name: /dev/sda1
+    ebs_volume_size: 20
+    ebs_delete_on_termination: true
+  - ebs_device_name: /dev/sda2
+    ebs_volume_type: gp2
+    ebs_virtual_name: test
+    ebs_volume_size: 15
+    ebs_delete_on_termination: true
+    ebs_snapshot_id: snap-0015d0bc
+```
+
+The keys `ebs_device_name`, `ebs_volume_size` and `ebs_delete_on_termination` are required for every mapping.
+For backwards compatiability a default `block_device_mappings` will be created if none are listed and the deprecated
+storage config keys are present.
+
+The keys `ebs_volume_type`, `ebs_virtual_name` and `ebs_snapshot_id` are optional.  See
+[Amazon EBS Volume Types](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html) to find out more about
+volume types. `ebs_volume_type` defaults to `standard` but can also be `gp2` or `io1`.
+
+If you have a block device mapping with a `ebs_device_name` equal to the root storage device name on your
+[image](#config-image-id) then the provided mapping will replace the settings in the image.
+
+If this is not provided it will use the default block_device_mappings from the AMI.
+
+### ebs\_optimized
+
+Option to launch EC2 instance with optimized EBS volume. See
+[Amazon EC2 Instance Types](http://aws.amazon.com/ec2/instance-types/) to find
+out more about instance types that can be launched as EBS-optimized instances.
+
+The default is `false`.
+
+## Network and Communication Configuration
+
+### associate\_public\_ip
+
+AWS does not automatically allocate public IP addresses for instances created
+within non-default [subnets][subnet_docs]. Set this option to `true` to force
+allocation of a public IP and associate it with the launched instance.
+
+If you set this option to `false` when launching into a non-default
+[subnet][subnet_docs], Test Kitchen will be unable to communicate with the
+instance unless you have a VPN connection to your
+[Virtual Private Cloud][vpc_docs].
+
+The default is `true` if you have configured a [subnet_id](#config-subnet-id),
+or `false` otherwise.
+
+### private\_ip\_address
+
+The primary private IP address of your instance.
+
+If you don't set this it will default to whatever DHCP address EC2 hands out.
+
+### interface
 
 The place from which to derive the hostname for communicating with the instance.  May be `dns`, `public` or `private`.  If this is unset, the driver will derive the hostname by failing back in the following order:
 
@@ -138,32 +288,53 @@ The place from which to derive the hostname for communicating with the instance.
 
 The default is unset.
 
+### ssh\_key
 
-### <a name="config-region"></a> region
-
-**Required** The AWS [region][region_docs] to use.
-
-The default is `"us-east-1"`.
+**Deprecated** Instead use the `transport.ssh_key` like
 
-### <a name="config-ssh-key"></a> ssh\_key
+```ruby
+transport:
+  ssh_key: ~/.ssh/id_rsa
+```
 
 Path to the private SSH key used to connect to the instance.
 
 The default is unset, or `nil`.
 
-### <a name="config-subnet-id"></a> subnet\_id
+### ssh\_timeout
 
-The EC2 [subnet][subnet_docs] to use.
+**Deprecated** Instead use the `transport.connection_timeout` like
 
-The default is unset, or `nil`.
+```ruby
+transport:
+  connection_timeout: 60
+```
 
-### <a name="config-tags"></a> tags
+The number of seconds to sleep before trying to SSH again.
 
-The Hash of EC tag name/value pairs which will be applied to the instance.
+The default is `1`.
 
-The default is `{ "created-by" => "test-kitchen" }`.
+### ssh\_retries
+
+**Deprecated** Instead use the `transport.connection_retries` like
+
+```ruby
+transport:
+  connection_retries: 10
+```
+
+The number of times to retry SSH-ing into the instance.
+
+The default is `3`.
 
-### <a name="config-username"></a> username
+### username
+
+**Deprecated** Instead use the `transport.username` like
+
+```ruby
+transport:
+  username: ubuntu
+```
 
 The SSH username that will be used to communicate with the instance.
 
@@ -171,7 +342,7 @@ The default will be determined by the Platform name, if a default exists (see
 [amis.json][amis_json]). If a default cannot be computed, then the default is
 `"root"`.
 
-## <a name="example"></a> Example
+## Example
 
 The following could be used in a `.kitchen.yml` or in a `.kitchen.local.yml`
 to override default configuration.
@@ -180,45 +351,29 @@ to override default configuration.
 ---
 driver:
   name: ec2
-  aws_access_key_id: KAS...
-  aws_secret_access_key: 3UK...
   aws_ssh_key_id: id_rsa-aws
-  ssh_key: /path/to/id_rsa-aws
   security_group_ids: ["sg-1a2b3c4d"]
   region: us-east-1
-  availability_zone: us-east-1b
+  availability_zone: b
   require_chef_omnibus: true
   subnet_id: subnet-6d6...
-
-platforms:
-  - name: ubuntu-12.04
-    driver:
-      image_id: ami-fd20ad94
-      username: ubuntu
-  - name: centos-6.3
-    driver:
-      image_id: ami-ef5ff086
-      username: ec2-user
-
-suites:
-# ...
-```
-
-Both `.kitchen.yml` and `.kitchen.local.yml` files are pre-processed through
-ERB which can help to factor out secrets and credentials. For example:
-
-```yaml
----
-driver:
-  name: ec2
-  aws_access_key_id: <%= ENV['AWS_ACCESS_KEY'] %>
-  aws_secret_access_key: <%= ENV['AWS_SECRET_KEY'] %>
-  aws_ssh_key_id: <%= ENV['AWS_SSH_KEY_ID'] %>
-  ssh_key: <%= File.expand_path('~/.ssh/id_rsa') %>
-  security_group_ids: ["sg-1a2b3c4d"]
-  region: us-east-1
-  availability_zone: us-east-1b
-  require_chef_omnibus: true
+  iam_profile_name: chef-client
+  instance_type: t2.micro
+  associate_public_ip: true
+  private_ip_address: 10.0.0.27
+  interface: dns
+  block_device_mappings:
+    - ebs_device_name: /dev/sda0
+      ebs_volume_type: gp2
+      ebs_virtual_name: test
+      ebs_volume_size: 15
+      ebs_delete_on_termination: true
+
+transport:
+  ssh_key: /path/to/id_rsa-aws
+  connection_timeout: 10
+  connection_retries: 5
+  username: ubuntu
 
 platforms:
   - name: ubuntu-12.04
@@ -268,11 +423,12 @@ Apache 2.0 (see [LICENSE][license])
 [amis_json]:        https://github.com/test-kitchen/kitchen-ec2/blob/master/data/amis.json
 [ami_docs]:         http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html
 [aws_site]:         http://aws.amazon.com/
-[credentials_docs]: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/SettingUp_CommandLine.html#using-credentials-access-key
-[fog_gem]:          http://fog.io/
+[credentials_docs]: http://blogs.aws.amazon.com/security/post/Tx3D6U6WSFGOK2H/A-New-and-Standardized-Way-to-Manage-Credentials-in-the-AWS-SDKs
+[aws_sdk_gem]:      http://docs.aws.amazon.com/sdkforruby/api/index.html
 [group_docs]:       http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html
 [instance_docs]:    http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html
 [key_id_docs]:      http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/verifying-your-key-pair.html
 [kitchenci]:        http://kitchen.ci/
 [region_docs]:      http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html
 [subnet_docs]:      http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-subnet.html
+[vpc_docs]:         http://docs.aws.amazon.com/AmazonVPC/latest/GettingStartedGuide/ExerciseOverview.html