# valentyna6/final-work-bootcamp architecture

> Architecture diagram of the GitHub repository valentyna6/final-work-bootcamp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/valentyna6/final-work-bootcamp
- Repository: https://github.com/valentyna6/final-work-bootcamp

## Overview

##### Project type and purpose
- From the file tree and README, this is a Terraform-based Infrastructure-as-Code project targeting AWS.
- It defines reusable Terraform modules for key infrastructure components: an application load balancer (alb), auto-scaling WordPress servers (asg), RDS, ECR, and self-hosted GitHub runners.

##### File structure
- Top level:
- terraform/ (root folder for Terraform configuration)
- terraform.tfstate (state file)
- README.md
- Inside terraform/:
- main.tf, providers.tf, variables.tf, outputs.tf – orchestrate the modules and define provider settings
- modules/
– alb/
– asg/
– rds/
– ecr/
– github-runner/
– security/
- Each module has main.tf, variables.tf, outputs.tf (plus user_data scripts for asg and github-runner).

##### README for additional insights
- The README is minimal (“Final-Work-Bootcamp, test collaborator access”).

##### Diagramming conventions and elements
- Clear labels for each module and AWS resource
– Orange for compute (EC2/ASG/GitHub runners)
– Green for data services (RDS, ECR)
– Purple for networking (VPC, subnets, SG)
- Resources by VPC subnet (public vs. private)

##### Detailed breakdown of components
- security (SG definitions)
- alb → AWS::ApplicationLoadBalancer
- asg → AWS::AutoScalingGroup with user_data_wp.sh
- rds → AWS::RDS::DBInstance
- ecr → AWS::ECR::Repository
- github-runner → AWS::EC2::Instance autoscaled via ASG or Launch Template with user_data_github_runner.sh
- AWS Environment Boundary
- Internet Gateway → ALB → ASG(WordPress)
- ASG(WordPress) ↔ RDS in private subnet
- GitHub Runner ASG in private subnet, outbound to GitHub SaaS & ECR
- Annotations for Security Group attachments

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Terraform Control Plane
    TerraformCLI["Terraform Control Plane"]:::control
    TerraformCLI --> Modules
    TerraformCLI --> StateFile
    TerraformCLI --> README

    %% Terraform Modules Group
    subgraph "Terraform Modules"
        direction TB
        security["security"]:::terraformModule
        alb["alb"]:::terraformModule
        asg["asg"]:::terraformModule
        rds["rds"]:::terraformModule
        ecr["ecr"]:::terraformModule
        github["github-runner"]:::terraformModule
    end

    %% AWS Environment
    subgraph "AWS Environment"
        direction TB
        Internet["Internet"]:::external
        ALB_RS["Application Load Balancer"]:::network
        ASG_RS["Auto Scaling Group<br/>(WordPress EC2)"]:::compute
        RDS_RS["RDS Database"]:::data
        GitHubRS["GitHub Runner Fleet"]:::compute
        ECR_RS["ECR Repository"]:::data
        GitHubSaaS["GitHub SaaS"]:::external
    end

    %% Connections: Terraform modules to AWS resources
    security -->|"defines SGs"|Internet
    security --> ALB_RS
    security --> ASG_RS
    security --> RDS_RS
    security --> GitHubRS

    alb --> ALB_RS
    asg --> ASG_RS
    rds --> RDS_RS
    ecr --> ECR_RS
    github --> GitHubRS

    %% Runtime data flows
    Internet --> ALB_RS
    ALB_RS --> ASG_RS
    ASG_RS -->|TCP:3306| RDS_RS
    ASG_RS --> ECR_RS
    GitHubRS --> ECR_RS
    GitHubRS -->|"Register runners"| GitHubSaaS

    %% Click Events for Terraform components
    click TerraformCLI "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/main.tf"
    click security "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/security/main.tf"
    click alb "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/alb/main.tf"
    click asg "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/asg/main.tf"
    click rds "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/rds/main.tf"
    click ecr "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/ecr/main.tf"
    click github "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform/modules/github-runner/main.tf"
    click StateFile "https://github.com/valentyna6/final-work-bootcamp/blob/main/terraform.tfstate"
    click README "https://github.com/valentyna6/final-work-bootcamp/blob/main/README.md"

    %% Styles
    classDef control fill:#dddddd,stroke:#888888,stroke-width:1px
    classDef terraformModule fill:#cce5ff,stroke:#004085,stroke-width:1px
    classDef compute fill:#ffe5b4,stroke:#ff8c00,stroke-width:1px
    classDef data fill:#d4edda,stroke:#155724,stroke-width:1px
    classDef network fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
    classDef external fill:#f8d7da,stroke:#721c24,stroke-width:1px
    classDef state fill:#fdfd96,stroke:#fab300,stroke-width:1px
```
