Implementation
Deployment & Operational Guide
Essential operational commands for deploying, monitoring, and managing the ACME Mobility microservice infrastructure via Docker Compose.
1. Repository Cloning & Stack Startup
Clone the official GitHub repository, navigate to the application root directory, and start all microservices with Docker Compose:
# Clone repository & navigate to application directory
git clone https://github.com/NicolasCola7/MSA-Project.git
cd MSA-Project/acme-mobility
# Build and start all 11 microservices in background mode
docker compose up -d --build
2. Status Inspection & Log Monitoring
Commands for checking container health status and monitoring live logs during system operation:
# Check running status and healthcheck of all containers
docker compose ps
# Tail live logs in real time (all services or a specific service)
docker compose logs -f [rental-service|orchestration|fm-gateway]
3. Shutdown & Clean Reset
Commands for gracefully stopping containers or performing a full state reset:
# Graceful shutdown (preserves persistent database volumes)
docker compose down
# Complete shutdown & reset (deletes persistent volumes: PostgreSQL, Zeebe, Redis)
docker compose down -v
Complete Host Port Mapping
Summary table of all 15 port bindings mapped by Docker Compose to the host machine:
| Host Port | Container Service | Protocol | Purpose |
|---|---|---|---|
| 4200 | Frontend Client | HTTP / Angular | Angular Single Page Application (Leaflet map, booking, SSE) |
| 8080 | Rental Service | HTTP / REST / SSE | Application gateway and primary domain state owner |
| 8082 | Account Registration Service | HTTP / REST | Jolie microservice for bank account creation |
| 8083 | Camunda Web Engine | HTTP | Camunda Web Management UI (demo/demo) |
| 8084 | Stations Service | HTTP / REST | Station catalog and physical unlock, lock, recharge commands |
| 8085 | Maintenance Service | HTTP / REST | FIFO vehicle repair queue management |
| 8000 | Bank Service | SOAP / XML | Jolie bank service (pre-authorization deposit & settlement) |
| 8091 | Fleet Management Gateway | HTTP / REST | GraphHopper route simulation and telemetry gateway |
| 8092 | Tracking Service | gRPC | Real-time GPS coordinate tracking service |
| 8093 | Battery Service | gRPC | Battery charge level monitoring service |
| 26500 | Zeebe Gateway | gRPC | Native gRPC gateway port for Zeebe worker job correlation |
| 5432 | PostgreSQL Rental DB | TCP / SQL | Primary domain database for ACME Mobility |
| 5433 | PostgreSQL Bank DB | TCP / SQL | Isolated database for Jolie bank accounts |
| 6379 | Redis Server | TCP / RESP | Pub/Sub async messaging and real-time SSE event stream broker |