Skip to content

Latest commit

 

History

History
121 lines (90 loc) · 8.45 KB

README.md

File metadata and controls

121 lines (90 loc) · 8.45 KB
Raw

OPSd

Meet OPSd. The unique and effortless way of managing cloud infrastructure.

terraform-module-aws-instance

Introduction

What does the module provide?

Usage

module "module_name" {
  source  = "github.com/opsd-io/terraform-module-aws-instance"

  name          = "my-host"
  ami_id        = data.aws_ami.debian11.id
  instance_type = "t2.micro"
  subnet_id     = module.network.public_subnet_groups["public1"]["a"].id
  key_name      = aws_key_pair.me.key_name
}

IMPORTANT: Make sure not to pin to master because there may be breaking changes between releases.

Requirements

Name Version
terraform >= 1.3.1
aws ~> 5.0

Providers

Name Version
aws ~> 5.0

Modules

No modules.

Resources

Name Type
aws_instance.main resource
aws_route53_record.private_cnames resource
aws_route53_record.private_ip resource
aws_route53_record.public_cnames resource
aws_route53_record.public_ip resource
aws_ec2_instance_type.main data source

Inputs

Name Description Type Default Required
ami_id AMI to use for the instance. Overrides the AMI specified in the Launch Template. string null no
associate_public_ip_address Whether to associate a public IP address with an instance in a VPC. Overrides subnet setting. bool null no
common_tags A map of tags to assign to every resource in this module. map(string) {} no
ebs_optimized If true, the launched EC2 instance will be EBS-optimized. bool null no
enable_resource_name_dns_a_record Indicates whether to respond to DNS queries for instance hostnames with DNS A records. Overrides subnet setting. bool null no
enable_resource_name_dns_aaaa_record Indicates whether to respond to DNS queries for instance hostnames with DNS AAAA records. Overrides subnet setting. bool null no
hostname_type Type of hostname for Amazon EC2 instances. Valid values: ip-name and resource-name. Overrides subnet setting. string null no
iam_instance_profile IAM Instance Profile to launch the instance with. string null no
instance_type Instance type to use for the instance. Overrides the instance type specified in the Launch Template. string null no
key_name Key name of the Key Pair to use for the instance. string null no
monitoring If true, the launched EC2 instance will have detailed monitoring enabled. bool false no
name The 'Name' tag of instance. string n/a yes
private_zone_id The ID of the hosted zone to contain private IP record. string null no
private_zone_record_cnames The CNAMEs of the private zone record. list(string) [] no
private_zone_record_name The name of the private zone record. Fallback to instance name. string null no
private_zone_record_ttl The TTL of the private records. number 600 no
public_zone_id The ID of the hosted zone to contain public IP record, if any. string null no
public_zone_record_cnames The CNAMEs of the public zone record. list(string) [] no
public_zone_record_name The name of the public zone record. Fallback to instance name. string null no
public_zone_record_ttl The TTL of the public records. number 600 no
root_iops Amount of provisioned IOPS. Only valid for root_volume_type of io1, io2 or gp3. Defaults to AMI setting. number null no
root_volume_encryption Whether to enable root volume encryption. Defaults to AMI setting. bool null no
root_volume_size Size of the root volume in gibibytes (GiB). Defaults to AMI setting. number null no
root_volume_type Type of root volume. Defaults to AMI setting. string null no
security_group_ids List of security group IDs to associate with. list(string) [] no
source_dest_check Controls if traffic is routed to the instance when the destination address does not match the instance. bool true no
subnet_id VPC Subnet ID to launch in. string n/a yes
user_data User data to provide when launching the instance. string null no
user_data_base64 User data to provide when launching the instance. string null no

Outputs

Name Description
arn The ARN of the instance.
id The ID of the instance.
private_ip The private IP of the instance.
public_ip The public IP of the instance.
root_volume_id The ID of the root volume.

Examples of usage

Do you want to see how the module works? See all the usage examples.

Related modules

The list of related modules (if present).

Contributing

If you are interested in contributing to the project, see see our guide.

Support

If you have a problem with the module or want to propose a new feature, you can report it via the project's (Github) issue tracker.

If you want to discuss something in person, you can join our community on Slack.

License

Apache License 2.0