aws_ec2_launch_templates Resource
Use the aws_ec2_launch_templates InSpec audit resource to test properties of a all the AWS Launch templates.
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_templates resource block declares the tests for a all the AWS Launch templates.
describe aws_ec2_launch_templates do it { should exist } end
Parameters
launch_templates_idThe ID of the EC2 launch_templates. This is in the format of
lt-followed by 8 or 17 hexadecimal characters. This can be passed either as a string or as anlaunch_templates_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 template.
created_by- The name by whom the launch template is created.
default_version_number- The default_version_number of the launch template.
latest_version_number- The latest_version_number of the launch template.
tags- A list of hashes with each key-value pair corresponding to an EC2 Launch template 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 templates should exist.
describe aws_ec2_launch_templates do it { should exist } end
Test that an EC2 instance is using the correct AMI.
describe aws_ec2_launch_templates do its(’launch_template_ids.count’) { should cmp 3 } end
Test that an EC2 instance has the correct tag.
describe aws_ec2_launch_templates do its(’launch_templates_names’) { should include ’test-lt’ } end
Matchers
For a full list of available matchers, please visit our Universal Matchers page.