# terraform-aws-modules/terraform-aws-ecs architecture

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

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

## Overview

##### Project Type and Purpose
This is an Infrastructure as Code (IaC) module specifically for creating AWS Elastic Container Service (ECS) resources. The module supports both Fargate and EC2-based container deployments with various configuration options.

##### Main Components

A. Core Components (Primary Layer):
- ECS Cluster
- ECS Services
- Container Definitions
- Task Definitions

B. Supporting Components (Secondary Layer):
- Capacity Providers (Fargate and EC2 Auto Scaling)
- CloudWatch Logs
- IAM Roles and Policies
- Load Balancers
- Service Connect Configuration

**Rectangle: Main Module Components**
**Hexagon: AWS Services**
**Shield: Security Components**

**Top Level:**

- ECS Module    |

- v
**[Split into three main sections]**

**Left Section:         Middle Section:         Right Section:**
**[Cluster Config]      [Service Config]        [Supporting Services]**

##### Component Relationships

a. Primary Flows:
- Cluster → Services → Tasks → Containers
- Capacity Providers → Cluster
- Services → Load Balancer
- Tasks → CloudWatch Logs

b. Security Flows:
- IAM Roles → Tasks
- Security Groups → Services
- KMS → CloudWatch Logs

##### Specific Implementation Details

- Blue: Core ECS components
- Green: Networking components
- Yellow: Security components
- Purple: Monitoring/logging components

Specific module features:
- Fargate and EC2 capacity provider options
- Service Connect configuration
- Container definition support
- Task execution roles
- CloudWatch logging integration

##### Implementation Notes

- The modular nature of the implementation
- The flexibility between Fargate and EC2 deployment options
- Security group and IAM role integrations
- Service discovery and load balancer connections

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "ECS Module"
        ModuleConfig["Module Configuration"]
        ModuleVars["Module Variables"]
        ModuleOutputs["Module Outputs"]
        ModuleDocs["Module Documentation"]
    end

    subgraph "Core Components"
        Cluster["ECS Cluster"]
        Services["ECS Services"]
        ContainerDefs["Container Definitions"]
        TaskDefs["Task Definitions"]
    end

    subgraph "Capacity Providers"
        FargateCP["Fargate Provider"]
        EC2CP["EC2 Auto Scaling Provider"]
    end

    subgraph "Supporting Services"
        CloudWatch[("CloudWatch Logs")]
        IAM["IAM Roles & Policies"]
        ALB["Load Balancer"]
        ServiceConnect["Service Connect"]
    end

    subgraph "Wrappers"
        ClusterWrapper["Cluster Wrapper"]
        ServiceWrapper["Service Wrapper"]
        ContainerWrapper["Container Definition Wrapper"]
    end

    %% Relationships
    ModuleConfig --> Cluster
    ModuleConfig --> Services
    ModuleVars --> ModuleConfig
    ModuleConfig --> ModuleOutputs

    Cluster --> Services
    Services --> TaskDefs
    TaskDefs --> ContainerDefs

    FargateCP --> Cluster
    EC2CP --> Cluster

    Services --> ALB
    TaskDefs --> CloudWatch
    IAM --> TaskDefs
    Services --> ServiceConnect

    ClusterWrapper --> Cluster
    ServiceWrapper --> Services
    ContainerWrapper --> ContainerDefs

    %% Styling
    classDef core fill:#2374ab
    classDef security fill:#ffd700
    classDef monitoring fill:#9b59b6
    classDef wrapper fill:#95a5a6
    classDef module fill:#27ae60

    class Cluster,Services,ContainerDefs,TaskDefs core
    class IAM security
    class CloudWatch monitoring
    class ClusterWrapper,ServiceWrapper,ContainerWrapper wrapper
    class ModuleConfig,ModuleVars,ModuleOutputs,ModuleDocs module

    %% Click events
    click Cluster "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/modules/cluster/main.tf"
    click Services "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/modules/service/main.tf"
    click ContainerDefs "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/modules/container-definition/main.tf"
    click FargateCP "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/examples/fargate/main.tf"
    click EC2CP "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/examples/ec2-autoscaling/main.tf"
    click ClusterWrapper "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/wrappers/cluster/main.tf"
    click ServiceWrapper "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/wrappers/service/main.tf"
    click ContainerWrapper "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/wrappers/container-definition/main.tf"
    click ModuleConfig "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/main.tf"
    click ModuleVars "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/variables.tf"
    click ModuleOutputs "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/outputs.tf"
    click ModuleDocs "https://github.com/terraform-aws-modules/terraform-aws-ecs/blob/master/docs/README.md"
```
