# amanpathak-devops/terraform-for-aws architecture

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

- Interactive diagram: https://gitdiagram.com/amanpathak-devops/terraform-for-aws
- Repository: https://github.com/amanpathak-devops/terraform-for-aws

## Overview

##### Project Type and Purpose
- This is an Infrastructure-as-Code (IaC) repository using Terraform to provision AWS services.
- It demonstrates two styles:
- Non-Modularized: individual Terraform projects, each directly defining AWS resources (e.g., ALB-EC2, API-Gateway-POST, Three-Tier-Application, etc.).
- Modularized: a reusable set of Terraform modules (VPC, EC2, Lambda, S3, SNS) plus environment-specific root configurations that assemble those modules.

##### Main Components
a. Code Repository
– Folders: Non-Modularized/, Modularized/ (with Terraform-Modularized/ root), CI configs (.circleci/, .github/workflows/, Jenkinsfile)
b. CI/CD Pipelines
– CircleCI or GitHub Actions pipeline (terraform.yml)
– Jenkins pipeline (Jenkinsfile)
c. Terraform CLI & Backend
– terraform init/plan/apply in each project
– backend configuration files (backend.tf) pointing at remote state (S3 or Terraform Cloud)
d. AWS Provider & Account
– Single AWS account (or one per environment)
– Authentication via AWS credentials or role assumption
e. AWS Resources
– Core modules: VPC (subnets, route tables), EC2, Lambda, S3, SNS
– Additional services: RDS, DynamoDB, CloudFront, API Gateway, ASG/ELB, CloudWatch, IAM, etc.

##### Relationships and Interactions
- The CI/CD system monitors GitHub for changes → triggers Terraform workflow → invokes Terraform CLI on a root folder (either a non-modular project or a modular root).
- Terraform CLI calls out to AWS via the AWS provider.
- For the Modularized path: root configurations (e.g., EC2-Instance, S3-Bucket) depend on child modules in Modules/ (Terraform-VPC → Terraform-EC2 → Terraform-Lambda, etc.).
- The modules encapsulate resource definitions and expose input/output variables; root modules wire input variables (e.g., VPC ID) into child modules.
- Terraform uses a remote state backend (S3) to store state files and to share outputs between modules/environments.

##### Architectural Patterns & Design Principles
- Infrastructure as Code: all resources are declared in source-controlled Terraform files.
- Modularization: reusable modules for common services to reduce duplication and simplify maintenance.
- Environment Isolation: dev.tfvars (and other .tfvars per environment) drive configuration differences.
- CI/CD Integration: pipelines automate validation, planning, and apply stages.
- Separation of Concerns:
- Non-Modularized examples illustrate direct provisioning – ideal for learning or small demos.
- Modularized approach abstracts common patterns into modules for production-scale use.

##### Essential Elements
- Code push → CI/CD → Terraform init/plan/apply
- Terraform CLI → Remote State Backend
- Terraform CLI → AWS Provider → AWS Resources
- Root module → Child module dependencies
- Code (blue), CI (purple), State (gray), Modules (teal), AWS services (orange).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Code Repository
    subgraph "Code Repository" 
        direction TB
        Repo_NonMod["Non-Modularized/"]:::code
        Repo_ModRoot["Modularized/Terraform-Modularized/"]:::code
        CI_CircleCI[".circleci/config.yml"]:::ci
        CI_GHA[".github/workflows/terraform.yml"]:::ci
        CI_Jenkins_NM["Non-Modularized/Jenkinsfile"]:::ci
        CI_Jenkins_M["Modularized/Terraform-Modularized/Jenkinsfile"]:::ci
    end

    %% CI/CD Pipelines
    subgraph "CI/CD Pipelines" 
        direction TB
        CircleCI["CircleCI Pipeline"]:::ci
        GHA["GitHub Actions"]:::ci
        Jenkins["Jenkins Pipeline"]:::ci
    end

    %% Terraform Execution
    subgraph "Terraform CLI & Backend" 
        direction TB
        TF_CLI["Terraform CLI\n(init/plan/apply)"]:::terraform
        Backend_S3["Remote State Backend\n(S3)"]:::state
    end

    %% AWS Provider & Resources
    subgraph "AWS" 
        direction TB
        AWS_Provider["AWS Provider"]:::aws
        subgraph "AWS Resources"
            direction TB
            Networking["VPC, Subnets, Route Tables"]:::aws
            Compute["EC2, ASG/ELB"]:::aws
            Serverless["Lambda, API Gateway"]:::aws
            Storage["S3, RDS, DynamoDB"]:::aws
            Messaging["SNS"]:::aws
            Monitoring["CloudWatch, IAM"]:::aws
        end
    end

    %% Modularized Modules
    subgraph "Reusable Modules\n(Modularized/Modules)" 
        direction TB
        Mod_VPC["Terraform-VPC"]:::modules
        Mod_EC2["Terraform-EC2"]:::modules
        Mod_Lambda["Terraform-Lambda"]:::modules
        Mod_S3["Terraform-S3Bucket"]:::modules
        Mod_SNS["Terraform-SNS"]:::modules
    end

    %% Modularized Root Modules
    subgraph "Modularized Root Modules" 
        direction TB
        Root_VPC["VPC-Networking"]:::terraform
        Root_EC2["EC2-Instance"]:::terraform
        Root_S3["S3-Bucket"]:::terraform
        Root_SNS["SNS-Topic"]:::terraform
        Root_IAM["IAM-Roles"]:::terraform
    end

    %% Relationships
    Repo_NonMod -->|push| CircleCI
    Repo_NonMod -->|push| GHA
    Repo_NonMod -->|push| Jenkins
    Repo_ModRoot -->|push| CircleCI
    Repo_ModRoot -->|push| GHA
    Repo_ModRoot -->|push| Jenkins

    CircleCI --> TF_CLI
    GHA --> TF_CLI
    Jenkins --> TF_CLI

    TF_CLI --> Backend_S3
    TF_CLI --> AWS_Provider

    AWS_Provider --> Networking
    AWS_Provider --> Compute
    AWS_Provider --> Serverless
    AWS_Provider --> Storage
    AWS_Provider --> Messaging
    AWS_Provider --> Monitoring

    %% Non-Modularized projects call backend
    Repo_NonMod -->|init/plan/apply| TF_CLI

    %% Modularized roots into CLI
    Repo_ModRoot -->|init/plan/apply| TF_CLI

    %% Root modules depend on reusable modules
    Root_VPC -->|uses| Mod_VPC
    Root_EC2 -->|uses| Mod_EC2
    Root_S3 -->|uses| Mod_S3
    Root_SNS -->|uses| Mod_SNS
    Root_IAM -->|uses| Mod_VPC

    %% Click Events
    click CI_CircleCI "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/.circleci/config.yml"
    click CI_GHA "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/.github/workflows/terraform.yml"
    click CI_Jenkins_NM "https://github.com/amanpathak-devops/terraform-for-aws/tree/master/Non-Modularized/Jenkinsfile"
    click CI_Jenkins_M "https://github.com/amanpathak-devops/terraform-for-aws/tree/master/Modularized/Terraform-Modularized/Jenkinsfile"
    click Repo_NonMod "https://github.com/amanpathak-devops/terraform-for-aws/tree/master/Non-Modularized/"
    click Repo_ModRoot "https://github.com/amanpathak-devops/terraform-for-aws/tree/master/Modularized/Terraform-Modularized/"
    click Root_EC2 "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/EC2-Instance/main.tf"
    click Root_S3 "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/S3-Bucket/main.tf"
    click Root_SNS "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/SNS-Topic/main.tf"
    click Root_VPC "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/VPC-Networking/main.tf"
    click Root_IAM "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/IAM-Roles/policy.tf"

    click Mod_VPC "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/Modules/Terraform-VPC/main.tf"
    click Mod_EC2 "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/Modules/Terraform-EC2/main.tf"
    click Mod_Lambda "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/Modules/Terraform-Lambda/main.tf"
    click Mod_S3 "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/Modules/Terraform-S3Bucket/main.tf"
    click Mod_SNS "https://github.com/amanpathak-devops/terraform-for-aws/blob/master/Modularized/Terraform-Modularized/Modules/Terraform-SNS/main.tf"

    %% Styles
    classDef code fill:#D6E9FF,stroke:#333,stroke-width:1px
    classDef ci fill:#DFFFE0,stroke:#333,stroke-width:1px
    classDef terraform fill:#F0F0F0,stroke:#333,stroke-width:1px
    classDef state fill:#F0E0FF,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef aws fill:#FFE0B2,stroke:#333,stroke-width:1px
    classDef modules fill:#E0FFFF,stroke:#333,stroke-width:1px
```
