https://github.com/justsaumit/astroshop-gitops
GitOps implementation of OpenTelemetry Demo astronomy e-commerce app on AWS EKS. Features 19 microservices, Terraform IaC, ArgoCD for deployments, multi-environment setup, and full observability with distributed tracing.
https://github.com/justsaumit/astroshop-gitops
argocd gitops opentelemetry-demo terraform
Last synced: 17 days ago
JSON representation
GitOps implementation of OpenTelemetry Demo astronomy e-commerce app on AWS EKS. Features 19 microservices, Terraform IaC, ArgoCD for deployments, multi-environment setup, and full observability with distributed tracing.
- Host: GitHub
- URL: https://github.com/justsaumit/astroshop-gitops
- Owner: justsaumit
- Created: 2025-11-19T08:23:56.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-11-19T08:33:56.000Z (7 months ago)
- Last Synced: 2025-11-19T10:19:10.334Z (7 months ago)
- Topics: argocd, gitops, opentelemetry-demo, terraform
- Language: Mustache
- Homepage:
- Size: 3.72 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 Astroshop GitOps
A GitOps implementation of the OpenTelemetry Demo microservices application deployed on AWS EKS using Terraform and ArgoCD.
[](https://github.com/open-telemetry/opentelemetry-demo)
[](https://kubernetes.io/)
[](https://argo-cd.readthedocs.io/)
[](https://terraform.io/)
> **Note**: This is my attempt to deploy the [OpenTelemetry Demo](https://github.com/open-telemetry/opentelemetry-demo) (v2.1.3) on AWS using Terraform for infrastructure and ArgoCD for GitOps-based application management. Thanks to all the OpenTelemetry contributors for the amazing demo application!
## 📋 What's Inside
- **Infrastructure**: Terraform modules for AWS VPC and EKS cluster
- **Applications**: Helm charts for 19 microservices
- **GitOps**: ArgoCD ApplicationSet for multi-environment deployments
- **CI/CD**: GitHub Actions workflow for automated deployments
- **Observability**: OpenTelemetry instrumentation across all services
## 🏗️ Architecture
```
AWS Cloud
├── VPC (Terraform)
│ ├── Public Subnets
│ └── Private Subnets
│
└── EKS Cluster (Terraform)
├── Dev Environment (astroshop-dev)
├── QA Environment (astroshop-qa)
└── Prod Environment (astroshop-prod)
│
└── 19 Microservices
├── Frontend (React + Envoy)
├── Backend Services (Go, .NET, Python, Java, etc.)
└── Supporting Services (Kafka, Redis, Flagd)
```
## 📦 Repository Structure
```
.
├── astroshop-helm/ # Helm charts for all services
│ ├── accounting/
│ ├── cart/
│ ├── checkout/
│ ├── productcatalog/
│ └── ... (15 more services)
│
├── astroshop-terraform/ # Infrastructure as Code
│ ├── modules/
│ │ ├── eks/ # EKS cluster module
│ │ └── vpc/ # VPC networking module
│ └── main.tf
│
├── argocd/ # ArgoCD configurations
│ └── argocd-applicationset.yaml
│
└── .github/workflows/ # CI/CD pipelines
└── build-and-deploy.yaml
```
## 🚀 Quick Start
### Prerequisites
- AWS CLI configured with appropriate credentials
- kubectl, helm, terraform, and argocd CLI installed
- Docker for building images
### 1. Deploy Infrastructure
```bash
cd astroshop-terraform
terraform init
terraform apply -var-file=terraform.tfvars
# Configure kubectl
aws eks update-kubeconfig --region --name
```
### 2. Install ArgoCD
```bash
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
# Get admin password
kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
```
### 3. Deploy Applications
```bash
# Apply ApplicationSet
kubectl apply -f argocd/argocd-applicationset.yaml
# Verify applications
kubectl get applications -n argocd -l app.kubernetes.io/part-of=astroshop
```
### 4. Access the Application
```bash
kubectl port-forward -n astroshop-dev svc/opentelemetry-demo-frontendproxy 8080:8080
# Open http://localhost:8080
```
## 📸 Screenshots
### Homepage - Astronomy Shop
*Landing page: "The best telescopes to see the world closer"*
### Product Catalog
*Browse telescopes, binoculars, and astronomy equipment*
### Product Details
*Solar System Color Imager - $175.00 with recommendations*
### Shopping Cart
*Cart with currency conversion (USD to INR) and shipping calculation*
### Checkout - Address
*Shipping address form during checkout process*
### Checkout - Payment
*Payment details with credit card form*
### Order Confirmation
*Order confirmation with shipping details*
## 🌍 Multi-Environment Setup
| Environment | Namespace | Sync | Values File |
|------------|-----------|------|-------------|
| **Dev** | `astroshop-dev` | Auto | `values.yaml` |
| **QA** | `astroshop-qa` | Auto | `values-qa.yaml` |
| **Prod** | `astroshop-prod` | Manual | `values-prod.yaml` |
## 🎯 Services
**Frontend**: frontend, frontendproxy
**Backend**: productcatalog, cart, checkout, payment, shipping, currency, email, recommendation, ad
**Supporting**: kafka, valkey, flagd, accounting, fraud-detection, imageprovider, quote, loadgenerator
## 🔄 CI/CD Pipeline
GitHub Actions workflow automatically:
1. Builds Docker images on push to main
2. Tags with commit SHA
3. Updates image tags in GitOps repo using `yq`
4. Triggers ArgoCD sync for dev/qa environments
**Required Secrets**: `DOCKERHUB_USERNAME`, `DOCKERHUB_TOKEN`, `GITOPS_PAT`
## 🔧 Useful Commands
```bash
# View all applications
kubectl get applications -n argocd
# Sync specific app
argocd app sync astroshop-productcatalog-dev
# Check application status
argocd app get astroshop-productcatalog-prod
# View pod logs
kubectl logs -n astroshop-dev -l app=productcatalog -f
# Port forward to services
kubectl port-forward -n astroshop-dev svc/ 8080:8080
```
## 📝 License
MIT License - This is an educational project based on the OpenTelemetry Demo.
## 🙏 Acknowledgments
- [OpenTelemetry Demo](https://github.com/open-telemetry/opentelemetry-demo) team for the excellent microservices demo
- OpenTelemetry, ArgoCD, Kubernetes, and Terraform communities