cthiesfork-awspec 1.0.0

data/doc/_resource_types/cloudwatch_logs.md

@@ -0,0 +1,48 @@
+### exist
+
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it { should exist }
+end
+```
+
+### have_log_stream
+
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it { should have_log_stream('my-cloudwatch-logs-stream') }
+end
+```
+
+### have_metric_filter
+
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it { should have_metric_filter('my-cloudwatch-logs-metric-filter') }
+end
+```
+
+### have_subscription_filter
+
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it { should have_subscription_filter('my-cloudwatch-logs-subscription-filter') }
+end
+```
+or
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it do
+    should have_subscription_filter('my-cloudwatch-logs-subscription-filter')\
+      .filter_pattern('[host, ident, authuser, date, request, status, bytes]')
+  end
+end
+```
+
+### have_tag
+
+```ruby
+describe cloudwatch_logs('my-cloudwatch-logs-group') do
+  it { should have_tag('Name').value('my-cloudwatch-logs-group') }
+end
+```

data/doc/_resource_types/codebuild.md

@@ -0,0 +1 @@
+### exist

data/doc/_resource_types/codedeploy.md

@@ -0,0 +1 @@
+### exist

data/doc/_resource_types/codedeploy_deployment_group.md

@@ -0,0 +1,17 @@
+### exist
+
+You can set the `application_name` (default: `default`).
+
+```ruby
+describe codedeploy_deployment_group('my-codedeploy-deployment-group'), application_name: 'my-codedeploy-application' do
+  it { should exist }
+end
+```
+
+### have_autoscaling_group
+
+```ruby
+describe codedeploy_deployment_group('my-codedeploy-deployment-group'), application_name: 'my-codedeploy-application' do
+  it { should have_autoscaling_group('my-autoscaling-group') }
+end
+```

data/doc/_resource_types/customer_gateway.md

@@ -0,0 +1,25 @@
+### exist
+
+```ruby
+describe customer_gateway('my-customer-gateway') do
+  it { should exist }
+end
+```
+
+### be_pending, be_available, be_deleting, be_deleted
+
+```ruby
+describe customer_gateway('my-customer-gateway') do
+  it { should be_running }
+end
+```
+
+### have_tag
+
+```ruby
+describe customer_gateway('my-customer-gateway') do
+  it { should have_tag('Name').value('my-customer-gateway') }
+end
+```
+
+### its(:customer_gateway_id), its(:state), its(:type), its(:ip_address), its(:bgp_asn)

data/doc/_resource_types/directconnect_virtual_interface.md

@@ -0,0 +1,30 @@
+### first
+
+```ruby
+describe directconnect_virtual_interface('my-directconnect-virtual-interface') do
+  it { should exist }
+  it { should be_available }
+  its(:connection_id) { should eq 'dxcon-abcd5fgh' }
+  its(:virtual_interface_id) { should eq 'dxvif-aabbccdd' }
+  its(:amazon_address) { should eq '170.252.252.1/30' }
+  its(:customer_address) { should eq '123.456.789.2/30' }
+  its(:virtual_gateway_id) { should eq 'vgw-d234e5f6' }
+end
+```
+
+### exist
+
+```ruby
+describe directconnect_virtual_interface('my-directconnect-virtual-interface') do
+  it { should exist }
+end
+```
+
+### be_confirming, be_verifying, be_pending, be_available, be_deleting, be_deleted, be_rejected
+
+```ruby
+describe directconnect_virtual_interface('my-directconnect-virtual-interface') do
+  it { should exist }
+  it { should be_available }
+end
+```

data/doc/_resource_types/dynamodb_table.md

@@ -0,0 +1,52 @@
+### exist
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  it { should exist }
+end
+```
+
+### be_active
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  it { should be_active }
+end
+```
+
+### have_attribute_definition
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  it { should have_attribute_definition('my-dynamodb-table-attaribute1').attribute_type('S') }
+  it { should have_attribute_definition('my-dynamodb-table-attaribute2').attribute_type('N') }
+end
+```
+
+### have_key_schema
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  it { should have_key_schema('my-dynamodb-table-key_schema1').key_type('HASH') }
+  it { should have_key_schema('my-dynamodb-table-key_schema2').key_type('RANGE') }
+end
+```
+
+### advanced
+
+`dynamodb_table` can use `Aws::DynamoDB::Table` resource (see http://docs.aws.amazon.com/sdkforruby/api/Aws/DynamoDB/Table.html).
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  its('key_schema.first.key_type') { should eq 'HASH' }
+end
+```
+
+or
+
+```ruby
+describe dynamodb_table('my-dynamodb-table') do
+  its('resource.key_schema.first.key_type') { should eq 'HASH' }
+end
+```
+

data/doc/_resource_types/ebs.md

@@ -0,0 +1,49 @@
+### exist
+
+```ruby
+describe ebs('my-volume') do
+  it { should exist }
+end
+```
+
+### be_attached_to
+
+```ruby
+describe ebs('my-volume') do
+  it { should be_attached_to('my-ec2') }
+end
+```
+
+### be_creating, be_available, be_in_use, be_deleting, be_deleted, be_error
+
+```ruby
+describe ebs('my-volume') do
+  it { should be_in_use }
+end
+```
+
+### have_tag
+
+```ruby
+describe ebs('my-volume') do
+  it { should have_tag('Name').value('my-volume') }
+end
+```
+
+### advanced
+
+`ebs` can use `Aws::EC2::Volume` resource (see http://docs.aws.amazon.com/sdkforruby/api/Aws/EC2/Volume.html).
+
+```ruby
+describe ebs('my-volume') do
+  its('attachments.first.instance_id') { should eq 'i-ec12345a' }
+end
+```
+
+or
+
+```ruby
+describe ebs('my-volume') do
+  its('resource.attachments.first.instance_id') { should eq 'i-ec12345a' }
+end
+```

data/doc/_resource_types/ec2.md

@@ -0,0 +1,203 @@
+### exist
+
+```ruby
+describe ec2('my-ec2') do
+  it { should exist }
+end
+```
+
+### be_disabled_api_termination
+
+```ruby
+describe ec2('my-ec2') do
+  it { should be_disabled_api_termination }
+end
+```
+
+### be_pending, be_running, be_shutting_down, be_terminated, be_stopping, be_stopped
+
+```ruby
+describe ec2('my-ec2') do
+  it { should be_running }
+end
+```
+
+### have_classiclink
+
+```ruby
+describe ec2('my-ec2-classic') do
+  it { should have_classiclink('my-vpc') }
+end
+```
+
+### have_classiclink_security_group
+
+```ruby
+describe ec2('my-ec2-classic') do
+  it { should have_classiclink_security_group('sg-2a3b4cd5') }
+  it { should have_classiclink_security_group('my-vpc-security-group-name') }
+end
+```
+
+### have_credit_specification
+
+The credit option for CPU usage of T2 or T3 instance.
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_credit_specification('unlimited') }
+end
+```
+
+### have_ebs
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_ebs('vol-123a123b') }
+  it { should have_ebs('my-volume') }
+end
+```
+
+### have_eip
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_eip('123.0.456.789') }
+end
+```
+
+### have_event
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_event('system-reboot') }
+end
+```
+
+### have_events
+
+```ruby
+describe ec2('my-ec2') do
+  it { should_not have_events }
+end
+```
+
+### have_network_interface
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_network_interface('my-eni') }
+  it { should have_network_interface('eni-12ab3cde') }
+  it { should have_network_interface('my-eni').as_eth0 }
+end
+```
+
+### have_security_group
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_security_group('my-security-group-name') }
+  it { should have_security_group('sg-1a2b3cd4') }
+end
+```
+
+### have_security_groups
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_security_groups(['my-security-group-name-1', 'my-security-group-name-2']) }
+  it { should have_security_groups(['sg-1a2b3cd4', 'sg-5e6f7gh8']) }
+end
+```
+
+### have_tag
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_tag('Name').value('my-ec2') }
+end
+```
+
+### belong_to_subnet
+
+```ruby
+describe ec2('my-ec2') do
+  it { should belong_to_subnet('subnet-1234a567') }
+  it { should belong_to_subnet('my-subnet') }
+end
+```
+
+### belong_to_vpc
+
+```ruby
+describe ec2('my-ec2') do
+  it { should belong_to_vpc('vpc-ab123cde') }
+  it { should belong_to_vpc('my-vpc') }
+end
+```
+
+### have_iam_instance_profile
+
+```ruby
+describe ec2('my-ec2') do
+  it { should have_iam_instance_profile('Ec2IamProfileName') }
+end
+```
+
+### advanced
+
+`ec2` can use `Aws::EC2::Instance` resource (see http://docs.aws.amazon.com/sdkforruby/api/Aws/EC2/Instance.html).
+
+```ruby
+describe ec2('my-ec2') do
+  its('vpc.id') { should eq 'vpc-ab123cde' }
+end
+```
+
+or
+
+```ruby
+describe ec2('my-ec2') do
+  its('resource.vpc.id') { should eq 'vpc-ab123cde' }
+end
+```
+
+#### Awspec::DuplicatedResourceTypeError exception
+
+EC2 resources might have the same tag value and if you try to search for a
+specific instance using that tag/tag value you might found multiples results
+and receive a `Awspec::DuplicatedResourceTypeError` exception as result.
+
+To avoid such situations, you will want to use EC2 instances ID's and then use
+those ID's to test whatever you need.
+
+There are several different ways to provide such ID's, like using [Terraform output](https://www.terraform.io/docs/configuration/outputs.html) or even the
+AWS SDK directly:
+
+```ruby
+require 'awspec'
+require 'aws-sdk-ec2'
+
+tag_name = 'tag:Name'
+tag_value = 'foobar'
+servers = {}
+ec2 = Aws::EC2::Resource.new
+ec2.instances({filters: [{name: "#{tag_name}",
+                          values: ["#{tag_value}"]}]}).each do |i|
+  servers.store(i.id, i.subnet_id)
+end
+
+if servers.size == 0
+  raise "Could not find any EC2 instance with #{tag_name} = #{tag_value}!"
+end
+
+servers.each_pair do |instance_id, subnet_id|
+  describe ec2(instance_id) do
+    it { should exist }
+    it { should be_running }
+    its(:image_id) { should eq 'ami-12345foobar' }
+    its(:instance_type) { should eq 't2.micro' }
+    it { should belong_to_subnet(subnet_id) }
+  end
+end
+```

data/doc/_resource_types/ec2_account_attributes.md

@@ -0,0 +1,8 @@
+### first
+
+```ruby
+describe ec2_account_attributes do
+  its(:supported_platforms) { should include 'VPC' }
+  its(:max_instances) { should eq 20 }
+end
+```