# skmahe1077/aws-eks-terraform-argocd-shop-platform architecture

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

- Interactive diagram: https://gitdiagram.com/skmahe1077/aws-eks-terraform-argocd-shop-platform
- Repository: https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform

## Overview

This is a platform repository for provisioning AWS infrastructure and deploying a separate Workshop Shop application through GitOps. The workflow starts with the external application workflow building and publishing an image, then updating this repository’s deployment manifest. Argo CD watches the GitOps directory and reconciles its desired state into EKS. Terraform provisions the AWS resources and installs Argo CD. The README documents these relationships; no source excerpts were provided, so implementation-level calls and manifest details are not inferred.

Main entry points: [`terraform/infrastructure/main.tf`](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf) (Infrastructure Terraform), [`argocd/application.yaml`](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/argocd/application.yaml) (Argo CD), [`gitops/deployment.yaml`](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/gitops/deployment.yaml) (Shop Deployment), [`terraform/argocd/main.tf`](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/argocd/main.tf) (Argo CD Terraform)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["AWS provisioning"]
  node_infra_tf["Infrastructure Terraform<br/>[main.tf]"]
  node_vpc{{"VPC and networking<br/>[main.tf]"}}
  node_eks{{"EKS cluster<br/>[main.tf]"}}
  node_nodes{{"Managed node group<br/>[main.tf]"}}
  node_ecr[("ECR repository<br/>[main.tf]")]
  node_github_iam{{"GitHub OIDC / IAM<br/>[main.tf]"}}
  node_argocd_tf["Argo CD Terraform<br/>[main.tf]"]
end

subgraph group_delivery["GitOps delivery"]
  node_argocd["Argo CD<br/>[application.yaml]"]
  node_application["Argo CD Application<br/>[application.yaml]"]
end

subgraph group_desired["Desired workload"]
  node_deployment["Shop Deployment<br/>[deployment.yaml]"]
  node_service["Shop Service<br/>[service.yaml]"]
  node_shop_pods["Workshop Shop pods"]
end

node_operator(("Developer / operator"))
node_app_repo["Shop app repository"]
node_actions["GitHub Actions"]

node_infra_tf -->|"creates"| node_vpc
node_infra_tf -->|"creates"| node_eks
node_infra_tf -->|"creates"| node_nodes
node_infra_tf -->|"creates"| node_ecr
node_infra_tf -->|"creates"| node_github_iam
node_argocd_tf -->|"installs"| node_argocd
node_argocd_tf -->|"installs onto"| node_eks
node_operator -->|"edits and pushes"| node_app_repo
node_app_repo -->|"triggers"| node_actions
node_actions -->|"pushes image"| node_ecr
node_actions -->|"updates image"| node_deployment
node_operator -->|"applies"| node_application
node_application -->|"configures"| node_argocd
node_argocd -->|"syncs"| node_deployment
node_argocd -->|"syncs"| node_service
node_deployment -->|"declares"| node_shop_pods
node_service -.->|"serves"| node_shop_pods
node_argocd -->|"reconciles into"| node_eks

click node_infra_tf "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_vpc "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_eks "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_nodes "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_ecr "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_github_iam "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf"
click node_argocd_tf "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/argocd/main.tf"
click node_argocd "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/argocd/application.yaml"
click node_application "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/argocd/application.yaml"
click node_deployment "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/gitops/deployment.yaml"
click node_service "https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/gitops/service.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_infra_tf,node_vpc,node_eks,node_nodes,node_ecr,node_github_iam,node_argocd_tf toneBlue
class node_argocd,node_application toneAmber
class node_deployment,node_service,node_shop_pods toneMint
class node_operator,node_app_repo,node_actions toneIndigo
```

## Components

### AWS provisioning

- [Infrastructure Terraform](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [VPC and networking](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [EKS cluster](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [Managed node group](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [ECR repository](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [GitHub OIDC / IAM](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/infrastructure/main.tf): `terraform/infrastructure/main.tf`
- [Argo CD Terraform](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/terraform/argocd/main.tf): `terraform/argocd/main.tf`

### GitOps delivery

- [Argo CD](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/argocd/application.yaml): `argocd/application.yaml`
- [Argo CD Application](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/argocd/application.yaml): `argocd/application.yaml`

### Desired workload

- [Shop Deployment](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/gitops/deployment.yaml): `gitops/deployment.yaml`
- [Shop Service](https://github.com/skmahe1077/aws-eks-terraform-argocd-shop-platform/blob/main/gitops/service.yaml): `gitops/service.yaml`
- **Workshop Shop pods**

### Other components

- **Developer / operator**
- **Shop app repository**
- **GitHub Actions**

## Connections

- Infrastructure Terraform → VPC and networking: creates (evidence: `README.md`)
- Infrastructure Terraform → EKS cluster: creates (evidence: `README.md`)
- Infrastructure Terraform → Managed node group: creates (evidence: `README.md`)
- Infrastructure Terraform → ECR repository: creates (evidence: `README.md`)
- Infrastructure Terraform → GitHub OIDC / IAM: creates (evidence: `README.md`)
- Argo CD Terraform → Argo CD: installs (evidence: `README.md`)
- Argo CD Terraform → EKS cluster: installs onto (evidence: `README.md`)
- Developer / operator → Shop app repository: edits and pushes (evidence: `README.md`)
- Shop app repository → GitHub Actions: triggers (evidence: `README.md`)
- GitHub Actions → ECR repository: pushes image (evidence: `README.md`)
- GitHub Actions → Shop Deployment: updates image (evidence: `README.md`)
- Developer / operator → Argo CD Application: applies (evidence: `README.md`)
- Argo CD Application → Argo CD: configures (evidence: `README.md`)
- Argo CD → Shop Deployment: syncs (evidence: `README.md`)
- Argo CD → Shop Service: syncs (evidence: `README.md`)
- Shop Deployment → Workshop Shop pods: declares (evidence: `README.md`)
- Shop Service → Workshop Shop pods: serves
- Argo CD → EKS cluster: reconciles into (evidence: `README.md`)
