AWS Amazon EC2 AMI
This page shows how to write Terraform for Amazon EC2 AMI and write them securely.
aws_ami (Terraform)
The AMI in Amazon EC2 can be configured in Terraform with the resource name aws_ami. The following sections describe 5 examples of how to use the resource and its parameters.
Example Usage from GitHub
resource "aws_ami" "positive1" {
name = "terraform-example"
virtualization_type = "hvm"
root_device_name = "/dev/xvda"
ebs_block_device {
resource "aws_ami" "ebs_block_device_encrypted_set_to_true" {
name = "foo"
ebs_block_device {
device_name = "/dev/xvda"
volume_size = 8
resource "aws_ami" "ebs_block_device_encrypted_set_to_true" {
name = "foo"
ebs_block_device {
device_name = var.test_device
volume_size = var.test_volume
resource "aws_ami" "positive1" {
name = "terraform-example"
virtualization_type = "hvm"
root_device_name = "/dev/xvda"
ebs_block_device {
resource "aws_ami" "ebs_block_device_encrypted_set_to_true" {
name = "foo"
ebs_block_device {
device_name = "/dev/xvda"
volume_size = 8
Parameters
-
architectureoptional - string -
arnoptional computed - string -
descriptionoptional - string -
ena_supportoptional - bool -
hypervisoroptional computed - string -
idoptional computed - string -
image_locationoptional computed - string -
image_owner_aliasoptional computed - string -
image_typeoptional computed - string -
kernel_idoptional - string -
manage_ebs_snapshotsoptional computed - bool -
namerequired - string -
owner_idoptional computed - string -
platformoptional computed - string -
platform_detailsoptional computed - string -
publicoptional computed - bool -
ramdisk_idoptional - string -
root_device_nameoptional - string -
root_snapshot_idoptional computed - string -
sriov_net_supportoptional - string -
tagsoptional - map from string to string -
usage_operationoptional computed - string -
virtualization_typeoptional - string -
ebs_block_deviceset block-
delete_on_terminationoptional - bool -
device_namerequired - string -
encryptedoptional - bool -
iopsoptional - number -
snapshot_idoptional - string -
throughputoptional computed - number -
volume_sizeoptional computed - number -
volume_typeoptional - string
-
-
ephemeral_block_deviceset block-
device_namerequired - string -
virtual_namerequired - string
-
-
timeoutssingle block
Explanation in Terraform Registry
The AMI resource allows the creation and management of a completely-custom Amazon Machine Image (AMI). If you just want to duplicate an existing AMI, possibly copying it to another region, it's better to use
aws_ami_copyinstead. If you just want to share an existing AMI with another AWS account, it's better to useaws_ami_launch_permissioninstead.
Tips: Best Practices for The Other AWS Amazon EC2 Resources
In addition to the aws_default_vpc, AWS Amazon EC2 has the other resources that should be configured for security reasons. Please check some examples of those resources and precautions.
aws_default_vpc
Ensure to avoid using default VPC
It is better to define the own VPC and use it.
aws_network_acl_rule
Ensure your network ACL rule blocks unwanted inbound traffic
It is better to block unwanted inbound traffic.
aws_ebs_volume
Ensure to use a customer-managed key for EBS volume encryption
It is better to use a customer-managed key for EBS volume encryption. It can be gain more control over the encryption by using customer-managed keys (CMK).
aws_instance
Ensure to avoid storing AWS access keys in user data
It is better to avoid storing AWS access keys in user data. `aws_iam_instance_profile` could be used instead.
aws_security_group
Ensure your security group blocks unwanted inbound traffic
It is better to block unwanted inbound traffic.
CloudFormation Example
CloudFormation code does not have the related resource.
Frequently asked questions
What is AWS Amazon EC2 AMI?
AWS Amazon EC2 AMI is a resource for Amazon EC2 of Amazon Web Service. Settings can be wrote in Terraform.
Where can I find the example code for the AWS Amazon EC2 AMI?
For Terraform, the Checkmarx/kics, ffsclyh/config-lint and ffsclyh/config-lint source code examples are useful. See the Terraform Example section for further details.