# terraform-aws-modules/terraform-aws-ec2-instance architecture

> Architecture diagram of the GitHub repository terraform-aws-modules/terraform-aws-ec2-instance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/terraform-aws-modules/terraform-aws-ec2-instance
- Repository: https://github.com/terraform-aws-modules/terraform-aws-ec2-instance

## Overview

##### 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

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer and Terraform CLI
    Dev["Developer / Terraform CLI"]:::external

    %% Core Module
    subgraph "Core Terraform Module" 
        direction TB
        Core_Main["main.tf"]:::module
        Core_Var["variables.tf"]:::module
        Core_Out["outputs.tf"]:::module
        Core_Ver["versions.tf"]:::module
    end

    %% Example Configurations
    subgraph "Example Configurations" 
        direction TB
        subgraph "Complete Example"
            CE_Main["main.tf"]:::example
            CE_Var["variables.tf"]:::example
            CE_Out["outputs.tf"]:::example
            CE_Ver["versions.tf"]:::example
        end
        subgraph "Session Manager Example"
            SM_Main["main.tf"]:::example
            SM_Var["variables.tf"]:::example
            SM_Out["outputs.tf"]:::example
            SM_Ver["versions.tf"]:::example
        end
        subgraph "Volume Attachment Example"
            VA_Main["main.tf"]:::example
            VA_Var["variables.tf"]:::example
            VA_Out["outputs.tf"]:::example
            VA_Ver["versions.tf"]:::example
        end
    end

    %% Wrappers
    subgraph "Terragrunt Wrappers Layer"
        direction TB
        W_Main["main.tf"]:::wrapper
        W_Var["variables.tf"]:::wrapper
        W_Out["outputs.tf"]:::wrapper
        W_Ver["versions.tf"]:::wrapper
    end

    %% CI/CD Workflows
    subgraph "CI/CD Workflows (GitHub Actions)"
        direction TB
        CI_Lock["lock.yml"]:::ci
        CI_PR["pr-title.yml"]:::ci
        CI_Pre["pre-commit.yml"]:::ci
        CI_Release["release.yml"]:::ci
        CI_Stale["stale-actions.yaml"]:::ci
    end

    %% Documentation
    subgraph "Module Documentation"
        direction TB
        Doc_README["README.md"]:::doc
        Doc_CHANGELOG["CHANGELOG.md"]:::doc
        Doc_UPGRADE["UPGRADE-3.0.md"]:::doc
    end

    %% AWS Provider
    AWS_Provider["AWS Provider Plugin"]:::provider

    %% AWS Cloud Boundary
    subgraph "AWS Cloud" 
        style AWS Cloud fill:#FFE0B2,stroke:#E69A00
        direction TB
        subgraph "Data Sources"
            direction TB
            DS_AMI["AMI Lookup"]:::datasource
            DS_SSM["SSM Parameter"]:::datasource
            DS_PART["AWS Partition"]:::datasource
        end
        subgraph "Networking"
            direction TB
            RC_Subnet["Subnet"]:::resource
            RC_SG["Security Group"]:::resource
        end
        subgraph "Compute"
            direction TB
            RC_EC2_ON["EC2 Instance (On-Demand)"]:::resource
            RC_Spot["Spot Instance Request"]:::resource
        end
        subgraph "Storage"
            direction TB
            RC_EBS["EBS Volume"]:::resource
        end
        subgraph "Identity & Access"
            direction TB
            RC_IAM["IAM Role & Profile"]:::resource
        end
        RC_EIP["Elastic IP"]:::resource
    end

    %% Connections
    Dev -->|invokes| Core_Main
    Dev -->|invokes| Core_Var
    Dev -->|invokes| Core_Out
    Dev -->|invokes| Core_Ver

    CE_Main -->|passes inputs to| Core_Main
    SM_Main -->|passes inputs to| Core_Main
    VA_Main -->|passes inputs to| Core_Main

    W_Main -->|wraps| Core_Main

    Core_Main -->|uses provider| AWS_Provider
    Core_Var -->|defines inputs| Core_Main
    Core_Main -->|defines resources| Core_Out
    Core_Out -->|returns attributes| CE_Out
    Core_Out -->|returns attributes| SM_Out
    Core_Out -->|returns attributes| VA_Out

    AWS_Provider -->|API calls| DS_AMI
    AWS_Provider -->|API calls| DS_SSM
    AWS_Provider -->|API calls| DS_PART

    AWS_Provider -->|API calls| RC_Subnet
    AWS_Provider -->|API calls| RC_SG
    AWS_Provider -->|API calls| RC_IAM
    AWS_Provider -->|API calls| RC_EBS
    AWS_Provider -->|API calls| RC_EIP

    DS_AMI -->|lookup| RC_EC2_ON
    DS_SSM -->|lookup| RC_EC2_ON
    DS_PART -->|lookup| RC_EC2_ON

    RC_IAM -->|attached to| RC_EC2_ON
    RC_SG -->|attached to| RC_EC2_ON
    RC_Subnet -->|launched in| RC_EC2_ON
    RC_EBS -->|attached to| RC_EC2_ON
    RC_EIP -->|associated with| RC_EC2_ON

    RC_Spot -->|fulfillment results in| RC_EC2_ON

    %% Click Events
    click Core_Main "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//main.tf"
    click Core_Var "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//variables.tf"
    click Core_Out "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//outputs.tf"
    click Core_Ver "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//versions.tf"

    click CE_Main "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/complete/main.tf"
    click CE_Var "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/complete/variables.tf"
    click CE_Out "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/complete/outputs.tf"
    click CE_Ver "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/complete/versions.tf"

    click SM_Main "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/session-manager/main.tf"
    click SM_Var "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/session-manager/variables.tf"
    click SM_Out "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/session-manager/outputs.tf"
    click SM_Ver "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/session-manager/versions.tf"

    click VA_Main "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/volume-attachment/main.tf"
    click VA_Var "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/volume-attachment/variables.tf"
    click VA_Out "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/volume-attachment/outputs.tf"
    click VA_Ver "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//examples/volume-attachment/versions.tf"

    click W_Main "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//wrappers/main.tf"
    click W_Var "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//wrappers/variables.tf"
    click W_Out "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//wrappers/outputs.tf"
    click W_Ver "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//wrappers/versions.tf"

    click CI_Lock "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//.github/workflows/lock.yml"
    click CI_PR "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//.github/workflows/pr-title.yml"
    click CI_Pre "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//.github/workflows/pre-commit.yml"
    click CI_Release "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//.github/workflows/release.yml"
    click CI_Stale "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//.github/workflows/stale-actions.yaml"

    click Doc_README "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//README.md"
    click Doc_CHANGELOG "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//CHANGELOG.md"
    click Doc_UPGRADE "https://github.com/terraform-aws-modules/terraform-aws-ec2-instance/blob/master//UPGRADE-3.0.md"

    %% Styles
    classDef module fill:#D0E8FF,stroke:#5B9BD5
    classDef example fill:#E8F4FF,stroke:#2F75B5
    classDef wrapper fill:#E8F4FF,stroke:#2F75B5
    classDef ci fill:#F5E8FF,stroke:#B23AEE
    classDef doc fill:#F0F0F0,stroke:#808080
    classDef provider fill:#E0E0E0,stroke:#969696
    classDef datasource fill:#DFFFE0,stroke:#2E7D32
    classDef resource fill:#FFF2CC,stroke:#BF9000
    classDef external fill:#FFFFFF,stroke:#000000,stroke-width:2px
```
