aws_ec2_launch_template Resource

[edit on GitHub]

Use the aws_ec2_launch_template InSpec audit resource to test properties of a single AWS Launch Template.

Installation

This resource is available in the Chef InSpec AWS resource pack.

See the Chef InSpec documentation on cloud platforms for information on configuring your AWS environment for InSpec and creating an InSpec profile that uses the InSpec AWS resource pack.

Syntax

An aws_ec2_launch_template resource block declares the tests for a single AWS Launch Template by either launch_template_name or launch_template_id.

describe aws_ec2_launch_template(launch_template_id: 'lt-01a2349e94458a507') do
  it { should exist }
end

describe aws_ec2_launch_template(launch_template_name: 'my-template') do
  it { should exist }
end

Parameters

One of either the launch_template_name or launch_template_id must be be provided.

launch_template_id

The ID of the EC2 launch_template. This is in the format of lt- followed by 8 or 17 hexadecimal characters. This can be passed either as a string or as an launch_template_id: 'value' key-value entry in a hash.

Properties

launch_template_name

The name of launch template.

launch_template_id

The id of the launch template.

create_time

The create time of the launch resource.

created_by

The time the instance was launched.

default_version_number

The availability zone of the instance.

latest_version_number

A hash containing the security group ids and names associated with the instance.

tags

A list of hashes with each key-value pair corresponding to an EC2 instance tag, e.g, [{:key=>"Name", :value=>"Testing Box"}, {:key=>"Environment", :value=>"Dev"}].

There are also additional properties available. For a comprehensive list, see the API reference documentation

Examples

Test that an launch template should exist.

describe aws_ec2_launch_template(launch_template_id: 'lt-01a2349e94458a507') do
  it { should exist }
end

Test that an EC2 instance is using the correct AMI.

describe aws_ec2_launch_template(launch_template_id: 'lt-01a2349e94458a507') do
  its('default_version_number') { should eq 1 }
end

Test that an EC2 instance has the correct tag.

describe aws_ec2_launch_template(launch_template_id: 'lt-01a2349e94458a507') do
  its('launch_template_name') { should eq 'test-lt' }
end