How terraform-aws-modules/terraform-aws-ec2-instance works
Project type and purpose
• This is a Terraform module (“terraform-aws-ec2-instance”) that standardizes the provisioning of EC2 Instances (on-demand or spot) in AWS.
• The README describes inputs, outputs, supported resources (EC2, EIP, IAM role/profile, spot requests, data sources), and example use cases (complete instance, session manager, volume attachment).
File structure
• Top‐level Terraform files (main.tf, variables.tf, outputs.tf, versions.tf) define the core module.
• examples/ contains live configurations demonstrating usage patterns.
• wrappers/ offers Terragrunt‐friendly mini‐modules to simplify “for_each” usage.
• .github/workflows/ holds CI configurations (linting, release, stale issue management).
README for additional insights
• The README enumerates all AWS resources and data sources:
• aws_instance / aws_spot_instance_request
• aws_eip
• aws_iam_role + aws_iam_instance_profile + aws_iam_role_policy_attachment
• Data sources: aws_ami, aws_ssm_parameter, aws_partition
Essential architectural elements, don’t over-complexify
• Separate layers: Developer/Terraform, Module, Provider, Cloud
• Within Cloud, group network (VPC/Subnet/SG), compute (EC2 instance), storage (EBS), identity (IAM Role/Profile), networking adjunct (EIP), data lookups
• Call out optional spot-instance path vs. standard instance path