Local Infrastructure Stack

This directory contains a local development infrastructure stack using Docker Compose. It includes all necessary services for running and testing microservices locally.

Services Included

• Traefik: Reverse proxy and load balancer (Dashboard: http://localhost:8080)
• Consul: Service discovery and configuration (UI: http://localhost:8500)
• Postgres: Database (Port: 5432)
• Redis: Cache (Port: 6379)
• Prometheus: Metrics collection (UI: http://localhost:9090)
• Grafana: Metrics visualization (http://grafana.localhost, default: admin/admin)
• Loki: Log aggregation
• Jaeger: Distributed tracing (UI: http://localhost:16686)
• Example Services: service-a and service-b showing service-to-service communication

Prerequisites

• Docker and Docker Compose
• Add to /etc/hosts:

127.0.0.1 service-a.localhost
127.0.0.1 service-b.localhost
127.0.0.1 grafana.localhost

Usage

Start the stack:

./scripts/up.sh

Stop and clean up:

./scripts/down.sh

View logs:

./scripts/logs.sh

Testing the Services

1. Access service-a: http://service-a.localhost
2. Access service-b: http://service-b.localhost
3. View traces in Jaeger: http://localhost:16686
4. Check metrics in Grafana: http://grafana.localhost

Directory Structure

infrastructure-local/
├── compose/          # Docker Compose files
├── configs/          # Configuration for services
├── services/         # Example microservices
└── scripts/          # Helper scripts

Adding New Services

1. Add service definition to compose/docker-compose.yml
2. Add Traefik configuration if needed in configs/traefik/dynamic.yml
3. Add Prometheus scrape config in configs/prometheus/prometheus.yml
4. Start the stack with ./scripts/up.sh

Troubleshooting

1. Check service logs: ./scripts/logs.sh
2. Verify Docker network: docker network ls
3. Check Traefik dashboard: http://localhost:8080
4. Verify Consul service registration: http://localhost:8500