Start local development environment with EKS parity, Keycloak, and hot-reload
Starts local development environment with EKS parity, Keycloak, and hot-reload
/plugin marketplace add Lobbi-Docs/claude/plugin install lobbi-docs-aws-eks-helm-keycloak-plugins-aws-eks-helm-keycloak@Lobbi-Docs/claudeStart a complete local development environment that mirrors your EKS production setup.
/eks:dev-up [options]
--services - Comma-separated services to run (default: all from config)--mode - Mode: full, minimal, isolated (default: full)--keycloak - Start local Keycloak (default: true)--localstack - Start LocalStack for AWS services (default: true)--rebuild - Force rebuild containers (default: false)--no-hot-reload - Disable hot-reload with Skaffold (default: false)--port - Override default app port (default: 3000)--background - Run in background (default: false)/eks:dev-up
Starts Kind cluster, LocalStack, Keycloak, and all services with hot-reload.
/eks:dev-up --mode=minimal --services=api-gateway
/eks:dev-up --localstack=false
/eks:dev-up --background
LOCAL ENVIRONMENT
═════════════════════════════════════════════════════════════════════════
🔧 Kind Cluster: eks-local
├── Control Plane: 127.0.0.1:6443
├── Workers: 2
└── K8s Version: 1.28
🌐 Services:
├── NGINX Ingress: http://localhost:80
├── Docker Registry: http://localhost:5000
└── Application: http://localhost:3000
☁️ LocalStack (AWS Mock):
├── Endpoint: http://localhost:4566
├── Secrets Manager: ✅
├── ECR: ✅
└── SSM: ✅
🔐 Keycloak:
├── URL: http://localhost:8080
├── Admin: admin / admin
├── Realm: local
└── Test Users:
├── testuser / testpass (user role)
└── admin / adminpass (admin role)
📦 Your Services:
├── api-gateway: http://api-gateway.localhost
├── user-service: http://user-service.localhost
└── payment-service: http://payment-service.localhost
═════════════════════════════════════════════════════════════════════════
This command activates the dev-assistant agent for troubleshooting.
Check Prerequisites
Start Infrastructure
Create Kind Cluster
Setup Secrets
Deploy Services
Port Forward & Report
.env.local # Local environment variables
kubeconfig-local # Kubectl config for local cluster
Skaffold watches for changes:
src/**/*.ts → Sync to container (no rebuild)src/**/*.js → Sync to container (no rebuild)package.json → Rebuild containerDockerfile → Rebuild containercharts/**/* → Re-deploy Helm releaseTo stop the environment:
/eks:dev-down
Or manually:
# Stop Skaffold
Ctrl+C
# Delete Kind cluster
kind delete cluster --name eks-local
# Stop Docker services
docker-compose down -v
| Issue | Solution |
|---|---|
| Kind won't start | Check Docker resources (8GB RAM recommended) |
| Port 80 in use | Stop other services or use --port |
| Keycloak import fails | Check realm-export.json syntax |
| Services can't connect | Verify Docker network connectivity |
| Hot-reload not working | Check Skaffold sync configuration |
| Mode | CPU | Memory | Disk |
|---|---|---|---|
| Full | 4 cores | 8 GB | 20 GB |
| Minimal | 2 cores | 4 GB | 10 GB |
| Isolated | 1 core | 2 GB | 5 GB |