How aws-samples/eks-blueprints-for-terraform-workshop works
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: checkout.service.ts Checkout logic · team-stack.ts CDK bootstrap · checkout.controller.ts Checkout API · HttpOrdersService.ts Order service adapter
Components 20
Workshop platform
- Shared EKS platform
- GitOps Bridge
- Argo CD
- Cluster add-ons
- Static website
gitops
Environment bootstrap
- CDK bootstrap
cdk/lib/team-stack.ts - Terraform runner
- CodeCommit webhook
gitops/lambda/codecommit_webhook.py
Retail commerce
- Catalog service
gitops/retail-store-app/src/catalog - Checkout API
gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts - Checkout logic
gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts - Shipping rates
gitops/retail-store-app/src/checkout/src/checkout/shipping/MockShippingService.ts - Checkout persistence
gitops/retail-store-app/src/checkout/src/checkout/repositories/ICheckoutRepository.ts - Order service adapter
gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts - Orders API client
gitops/retail-store-app/src/checkout/src/clients/orders/api.ts
Service operations
- Load generator
gitops/retail-store-app/src/load-generator/helpers.js - Chaos controls
gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts - Chaos state
gitops/retail-store-app/src/checkout/src/chaos/chaos.service.ts - Health and topology
gitops/retail-store-app/src/checkout/src/app.controller.ts
Other components
- Workshop participant
Connections 15
- 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
gitops/retail-store-app/src/checkout/src/checkout/checkout.controller.ts - Checkout logic → Checkout persistence: reads and writes
gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts - Checkout logic → Shipping rates: requests rates
gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts - Checkout logic → Order service adapter: creates order
gitops/retail-store-app/src/checkout/src/checkout/checkout.service.ts - Order service adapter → Orders API client: uses client
gitops/retail-store-app/src/checkout/src/checkout/orders/HttpOrdersService.ts - Chaos controls → Chaos state: updates controls
gitops/retail-store-app/src/checkout/src/chaos/chaos.controller.ts - Health and topology → Chaos state: checks health
gitops/retail-store-app/src/checkout/src/app.controller.ts