# aws-samples/eks-blueprints-for-terraform-workshop architecture

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

- Interactive diagram: https://gitdiagram.com/aws-samples/eks-blueprints-for-terraform-workshop
- Repository: https://github.com/aws-samples/eks-blueprints-for-terraform-workshop

## Overview

This repository is workshop material for building a shared EKS platform with Terraform, GitOps Bridge, and Argo CD; it also contains CDK bootstrap code and a sample retail application. The documented platform workflow provisions workshop environments, bootstraps Terraform through CDK, and supports GitOps-based workload deployment. In the sample checkout service, customer requests pass through a controller to checkout logic, which consults shipping and persistence abstractions and creates an order on submission. The README documents platform capabilities not represented in the supplied tree; checkout relationships are grounded in the provided source index and excerpts.

Main entry points: [`gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts`](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts) (Checkout logic), [`cdk/lib/team-stack.ts`](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/cdk/lib/team-stack.ts) (CDK bootstrap), [`gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts`](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts) (Checkout API), [`gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts`](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts) (Order service adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Workshop platform"]
  node_eks{{"Shared EKS platform"}}
  node_gitopsbridge["GitOps Bridge"]
  node_argocd["Argo CD"]
  node_addons["Cluster add-ons"]
  node_staticwebsite["Static website"]
end

subgraph group_bootstrap["Environment bootstrap"]
  node_cdk["CDK bootstrap<br/>[team-stack.ts]"]
  node_terraform["Terraform runner"]
  node_webhook["CodeCommit webhook"]
end

subgraph group_commerce["Retail commerce"]
  node_catalog["Catalog service"]
  node_checkoutapi["Checkout API"]
  node_checkoutlogic["Checkout logic"]
  node_shipping["Shipping rates"]
  node_checkoutstore["Checkout persistence"]
  node_orders["Order service adapter"]
  node_ordersapi["Orders API client<br/>[api.ts]"]
end

subgraph group_operations["Service operations"]
  node_loadgen["Load generator<br/>[helpers.js]"]
  node_chaosapi["Chaos controls"]
  node_chaosstate["Chaos state<br/>[chaos.service.ts]"]
  node_health["Health and topology<br/>[app.controller.ts]"]
end

node_participant(("Workshop participant"))

node_participant -->|"deploys"| node_cdk
node_cdk -->|"runs Terraform"| node_terraform
node_participant -->|"builds platform"| node_eks
node_eks -->|"bootstraps through"| node_gitopsbridge
node_gitopsbridge -->|"configures"| node_argocd
node_eks -->|"enables"| node_addons
node_argocd -->|"deploys"| node_staticwebsite
node_participant -.->|"submits checkout"| node_checkoutapi
node_checkoutapi -->|"calls"| node_checkoutlogic
node_checkoutlogic -->|"reads and writes"| node_checkoutstore
node_checkoutlogic -->|"requests rates"| node_shipping
node_checkoutlogic -->|"creates order"| node_orders
node_orders -->|"uses client"| node_ordersapi
node_chaosapi -->|"updates controls"| node_chaosstate
node_health -->|"checks health"| node_chaosstate

click node_staticwebsite "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/tree/main/gitops"
click node_cdk "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/cdk/lib/team-stack.ts"
click node_webhook "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/lambda/codecommit_webhook.py"
click node_catalog "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/tree/main/gitops/retail-store-app/src/catalog"
click node_checkoutapi "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts"
click node_checkoutlogic "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts"
click node_shipping "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/shipping/MockShippingService.ts"
click node_checkoutstore "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/repositories/ICheckoutRepository.ts"
click node_orders "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts"
click node_ordersapi "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/clients/orders/api.ts"
click node_loadgen "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/load-generator/helpers.js"
click node_chaosapi "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts"
click node_chaosstate "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/chaos/chaos.service.ts"
click node_health "https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/app.controller.ts"

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_eks,node_gitopsbridge,node_argocd,node_addons,node_staticwebsite toneBlue
class node_cdk,node_terraform,node_webhook toneAmber
class node_catalog,node_checkoutapi,node_checkoutlogic,node_shipping,node_checkoutstore,node_orders,node_ordersapi toneMint
class node_loadgen,node_chaosapi,node_chaosstate,node_health toneRose
class node_participant toneIndigo
```

## Components

### Workshop platform

- **Shared EKS platform**
- **GitOps Bridge**
- **Argo CD**
- **Cluster add-ons**
- [Static website](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/tree/main/gitops): `gitops`

### Environment bootstrap

- [CDK bootstrap](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/cdk/lib/team-stack.ts): `cdk/lib/team-stack.ts`
- **Terraform runner**
- [CodeCommit webhook](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/lambda/codecommit_webhook.py): `gitops/lambda/codecommit_webhook.py`

### Retail commerce

- [Catalog service](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/tree/main/gitops/retail-store-app/src/catalog): `gitops/retail-store-app/src/catalog`
- [Checkout API](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts): `gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts`
- [Checkout logic](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts): `gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts`
- [Shipping rates](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/shipping/MockShippingService.ts): `gitops/retail-store-app/src/checkout/src/checkout/shipping/MockShippingService.ts`
- [Checkout persistence](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/repositories/ICheckoutRepository.ts): `gitops/retail-store-app/src/checkout/src/checkout/repositories/ICheckoutRepository.ts`
- [Order service adapter](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts): `gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts`
- [Orders API client](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/clients/orders/api.ts): `gitops/retail-store-app/src/checkout/src/clients/orders/api.ts`

### Service operations

- [Load generator](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/load-generator/helpers.js): `gitops/retail-store-app/src/load-generator/helpers.js`
- [Chaos controls](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts): `gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts`
- [Chaos state](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/chaos/chaos.service.ts): `gitops/retail-store-app/src/checkout/src/chaos/chaos.service.ts`
- [Health and topology](https://github.com/aws-samples/eks-blueprints-for-terraform-workshop/blob/main/gitops/retail-store-app/src/checkout/src/app.controller.ts): `gitops/retail-store-app/src/checkout/src/app.controller.ts`

### Other components

- **Workshop participant**

## Connections

- Workshop participant → CDK bootstrap: deploys
- CDK bootstrap → Terraform runner: runs Terraform
- Workshop participant → Shared EKS platform: builds platform
- Shared EKS platform → GitOps Bridge: bootstraps through
- GitOps Bridge → Argo CD: configures
- Shared EKS platform → Cluster add-ons: enables
- Argo CD → Static website: deploys
- Workshop participant → Checkout API: submits checkout
- Checkout API → Checkout logic: calls (evidence: `gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts`)
- Checkout logic → Checkout persistence: reads and writes (evidence: `gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts`)
- Checkout logic → Shipping rates: requests rates (evidence: `gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts`)
- Checkout logic → Order service adapter: creates order (evidence: `gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts`)
- Order service adapter → Orders API client: uses client (evidence: `gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts`)
- Chaos controls → Chaos state: updates controls (evidence: `gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts`)
- Health and topology → Chaos state: checks health (evidence: `gitops/retail-store-app/src/checkout/src/app.controller.ts`)
