# jaswanthreddy5/aws-eks-devops-pipeline architecture

> Architecture diagram of the GitHub repository jaswanthreddy5/aws-eks-devops-pipeline, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jaswanthreddy5/aws-eks-devops-pipeline
- Repository: https://github.com/jaswanthreddy5/aws-eks-devops-pipeline

## Overview

This repository demonstrates a developer-to-EKS delivery pipeline for a small Flask service. A push triggers CI tests and builds a container for GHCR; Argo CD watches the Kubernetes manifests and syncs them to EKS, where the service runs and cluster monitoring is provided by kube-prometheus-stack. Terraform provisions remote state, networking, IAM and EKS. Relationships beyond the sampled Flask source are based on the README’s architecture and workflow descriptions; unsampled implementation details are not inferred.

Main entry points: [`terraform/eks.tf`](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/eks.tf) (EKS cluster), [`k8s/deployment.yaml`](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/k8s/deployment.yaml) (Kubernetes deployment), [`.github/workflows/ci.yml`](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/.github/workflows/ci.yml) (CI workflow), [`argocd/application.yaml`](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/argocd/application.yaml) (Argo CD application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Cloud provisioning"]
  node_bootstrap["State bootstrap<br/>[main.tf]"]
  node_remote_state[("Remote state")]
  node_network["VPC networking<br/>[vpc.tf]"]
  node_iam["EKS IAM roles<br/>[iam.tf]"]
  node_eks["EKS cluster<br/>[eks.tf]"]
end

subgraph group_delivery["Build and delivery"]
  node_actions["CI workflow<br/>[ci.yml]"]
  node_flask["Flask service<br/>[app.py]"]
  node_docker["Container image"]
end

subgraph group_workload["Kubernetes workload"]
  node_argocd["Argo CD application<br/>[application.yaml]"]
  node_deployment["Kubernetes deployment<br/>[deployment.yaml]"]
  node_service["LoadBalancer service<br/>[service.yaml]"]
end

subgraph group_observability["Cluster monitoring"]
  node_monitoring["Metrics stack<br/>[values.yaml]"]
  node_prometheus["Prometheus and Grafana"]
end

node_developer(("Developer"))
node_repository["Git repository"]
node_ghcr[("GHCR registry")]

node_developer -->|"pushes changes"| node_repository
node_repository -->|"triggers CI"| node_actions
node_repository -->|"provides watched manifests"| node_argocd
node_bootstrap -->|"creates state resources"| node_remote_state
node_network -->|"provides subnets"| node_eks
node_iam -->|"provides roles"| node_eks
node_actions -->|"tests application"| node_flask
node_actions -->|"builds image"| node_docker
node_docker -->|"pushes image"| node_ghcr
node_argocd -->|"syncs manifests"| node_deployment
node_argocd -->|"syncs manifests"| node_service
node_ghcr -->|"nodes pull image"| node_eks
node_eks -->|"runs workload"| node_deployment
node_deployment -->|"runs service"| node_flask
node_deployment -->|"exposes pods"| node_service
node_monitoring -->|"configures chart"| node_prometheus
node_prometheus -->|"scrapes cluster metrics"| node_eks

click node_bootstrap "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/bootstrap/main.tf"
click node_remote_state "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/backend.hcl.example"
click node_network "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/vpc.tf"
click node_iam "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/iam.tf"
click node_eks "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/eks.tf"
click node_actions "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/.github/workflows/ci.yml"
click node_flask "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/app/app.py"
click node_docker "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/app/Dockerfile"
click node_argocd "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/argocd/application.yaml"
click node_deployment "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/k8s/deployment.yaml"
click node_service "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/k8s/service.yaml"
click node_monitoring "https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/monitoring/values.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_remote_state,node_network,node_iam,node_eks toneBlue
class node_actions,node_flask,node_docker,node_ghcr toneAmber
class node_argocd,node_deployment,node_service toneMint
class node_monitoring,node_prometheus toneRose
class node_developer,node_repository toneIndigo
```

## Components

### Cloud provisioning

- [State bootstrap](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/bootstrap/main.tf): `terraform/bootstrap/main.tf`
- [Remote state](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/backend.hcl.example): `terraform/backend.hcl.example`
- [VPC networking](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/vpc.tf): `terraform/vpc.tf`
- [EKS IAM roles](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/iam.tf): `terraform/iam.tf`
- [EKS cluster](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/terraform/eks.tf): `terraform/eks.tf`

### Build and delivery

- [CI workflow](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/.github/workflows/ci.yml): `.github/workflows/ci.yml`
- [Flask service](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/app/app.py): `app/app.py`
- [Container image](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/app/Dockerfile): `app/Dockerfile`

### Kubernetes workload

- [Argo CD application](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/argocd/application.yaml): `argocd/application.yaml`
- [Kubernetes deployment](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/k8s/deployment.yaml): `k8s/deployment.yaml`
- [LoadBalancer service](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/k8s/service.yaml): `k8s/service.yaml`

### Cluster monitoring

- [Metrics stack](https://github.com/jaswanthreddy5/aws-eks-devops-pipeline/blob/main/monitoring/values.yaml): `monitoring/values.yaml`
- **Prometheus and Grafana**

### Other components

- **Developer**
- **Git repository**
- **GHCR registry**

## Connections

- Developer → Git repository: pushes changes (evidence: `README.md`)
- Git repository → CI workflow: triggers CI (evidence: `README.md`)
- Git repository → Argo CD application: provides watched manifests (evidence: `README.md`)
- State bootstrap → Remote state: creates state resources (evidence: `README.md`)
- VPC networking → EKS cluster: provides subnets (evidence: `README.md`)
- EKS IAM roles → EKS cluster: provides roles (evidence: `README.md`)
- CI workflow → Flask service: tests application (evidence: `README.md`)
- CI workflow → Container image: builds image (evidence: `README.md`)
- Container image → GHCR registry: pushes image (evidence: `README.md`)
- Argo CD application → Kubernetes deployment: syncs manifests (evidence: `README.md`)
- Argo CD application → LoadBalancer service: syncs manifests (evidence: `README.md`)
- GHCR registry → EKS cluster: nodes pull image (evidence: `README.md`)
- EKS cluster → Kubernetes deployment: runs workload (evidence: `README.md`)
- Kubernetes deployment → Flask service: runs service (evidence: `README.md`)
- Kubernetes deployment → LoadBalancer service: exposes pods (evidence: `README.md`)
- Metrics stack → Prometheus and Grafana: configures chart (evidence: `README.md`)
- Prometheus and Grafana → EKS cluster: scrapes cluster metrics (evidence: `README.md`)
