Skip to content

🐳 Run with Docker Only

🐳 Run the App Stack with Docker Only

No Kubernetes needed

The course apps (nginx, App1, App2, BuggyApp) run with nothing but Docker + Docker Compose, using the docker-compose.yml at the repo root. This is the fastest way to run everything locally.


✅ Prerequisites

  • Docker Desktop / OrbStack / colima running - that’s it 🙂

🚀 Build & run

From the repository root:

# Build all images in parallel (each service has its own Dockerfile under src/)
docker compose build

# Start the full stack in the background
docker compose up -d

# Watch the startup order & health checks
docker compose ps

Built-in startup order

Compose waits for health checks automatically: app1 must be healthy before app2 starts, and both must be healthy before nginx (the front door) launches.


🌐 Services & ports

Service Container port Host port Purpose
nginx 80 8080 Reverse proxy front door
App1 3000 5001 Tiny REST receiver
App2 3000 5002 Calls App1 over the Docker network
BuggyApp 80 5006 Intentionally buggy app for debugging practice

🔍 Verify the call chain

# Health check every service
curl http://localhost:8080/health
curl http://localhost:8080/app1/health
curl http://localhost:8080/app2/health

# POST an event through nginx -> App1 (note the /app1 prefix is stripped)
curl -X POST http://localhost:8080/app1/api/receive \
     -H "Content-Type: application/json" \
     -d '{"message": "hello through nginx"}'

# App2 -> App1, over the Docker network (by service name)
curl http://localhost:8080/app2/api/call-app1

# Or hit the services directly, bypassing the proxy
curl -X POST http://localhost:5001/api/receive \
     -H "Content-Type: application/json" \
     -d '{"message": "hello app1"}'

# Prove the bug exists before the debugging task
curl -s -o /dev/null -w "%{http_code}\n" http://localhost:5006/process   # 500

🧹 Teardown

docker compose down          # stop and remove containers
docker compose down -v       # ...and wipe volumes

➡️ Next steps