DevOps portfolio: GPS/GIS microservices with full CI/CD on AWS EKS
A full-stack GPS/GIS application tracking capital cities and geographical points of interest around the world, built as a DevOps portfolio project demonstrating the complete modern DevOps toolchain.
- Interactive world map with clickable markers for capital cities and special interest locations
- Expandable location cards showing coordinates and plain-language remarks
- Active/Passive toggle — show or hide any location on the map instantly
- Alphabetical sort and real-time search across all tracked points
- Any geographical point on Earth can be marked, tracked, and given plain-language remarks — demonstrated by a dam in Iran included as a real-world example
| Layer | Technology |
|---|---|
| Backend | Python FastAPI + PostgreSQL |
| Frontend | React + Vite + Leaflet Maps |
| Containerization | Docker + Docker Compose |
| CI/CD | Jenkins Pipeline |
| Orchestration | Kubernetes (minikube + AWS EKS) |
| Cloud | AWS EKS + ECR |
| Infrastructure as Code | Terraform |
| GitOps | Argo CD |
| Monitoring | Prometheus + Grafana (Helm) |
| Security | Trivy Image Scanning |
Prometheus and Grafana deployed via Helm into a dedicated monitoring namespace.
Access Grafana dashboard:
kubectl port-forward -n monitoring svc/monitoring-grafana 3000:80
# Open http://localhost:3000Jenkins runs in Docker, executing a 3-stage pipeline on every build:
- Checkout — pulls latest code from GitHub
- Test — runs pytest via Docker (3 DB-independent tests)
- Build — builds gps-backend and gps-frontend Docker images
- Trivy Scan — scans images for HIGH/CRITICAL vulnerabilities
Access Jenkins:
docker start jenkins
# Open http://localhost:8090Argo CD deployed to Kubernetes, watching the kubernetes/ folder in this repo.
Any push to main automatically syncs the live cluster — true GitOps. 🔄
Access Argo CD dashboard:
kubectl port-forward svc/argocd-server -n argocd 8080:443
# Open https://localhost:8080
# Username: adminDeveloper → GitHub → Jenkins CI/CD → Docker Images → Kubernetes → AWS EKS
↓
Argo CD (GitOps auto-sync)
↓
React Frontend + FastAPI Backend + PostgreSQL
↓
Prometheus + Grafana (Monitoring)
cd docker
docker-compose up
# Open http://localhost:5173minikube start --driver=docker
eval $(minikube docker-env)
docker build -t gps-backend:latest ./backend
docker build -t gps-frontend:latest ./frontend
kubectl apply -f kubernetes/
minikube service frontend-service --url| Method | Endpoint | Description |
|---|---|---|
| GET | /health | Health check |
| GET | /api/capitals | Get all cities |
| GET | /api/capitals/{id} | Get one city |
| POST | /api/capitals | Create city |
| PUT | /api/capitals/{id} | Update city |
| DELETE | /api/capitals/{id} | Delete city |
cd backend
pytest tests/ -v7/7 tests passing ✅
| Enhancement | Description |
|---|---|
| RBAC | Role-based access control with least-privilege principles |
| Network Policies | Pod-level network security and traffic control |
"A good DevOps engineer never stops improving the pipeline."
DevOps-ily — Built from scratch in under 2 weeks, under missile attacks, because nothing stops a DevOps engineer. 加油! 💙





