60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# Docker Services Guide
|
|
|
|
This repository contains multiple microservices that can be run using Docker Compose.
|
|
|
|
## Quick Start (With Cache)
|
|
For regular development when dependencies haven't changed:
|
|
```bash
|
|
# Build and run Auth Service
|
|
docker compose -f docker-compose-services.yml up auth-service
|
|
|
|
# Build and run Event Service
|
|
docker compose -f docker-compose-services.yml up event-service
|
|
|
|
# Build and run Validation Service
|
|
docker compose -f docker-compose-services.yml up validation-service
|
|
|
|
# Build and run all services
|
|
docker compose -f docker-compose-services.yml up
|
|
```
|
|
|
|
## Clean Build (No Cache)
|
|
Use these commands when changing Dockerfile or dependencies:
|
|
```bash
|
|
# Auth Service
|
|
docker compose -f docker-compose-services.yml build --no-cache auth-service && docker compose -f docker-compose-services.yml up auth-service
|
|
|
|
# Event Service
|
|
docker compose -f docker-compose-services.yml build --no-cache event-service && docker compose -f docker-compose-services.yml up event-service
|
|
|
|
# Validation Service
|
|
docker compose -f docker-compose-services.yml build --no-cache validation-service && docker compose -f docker-compose-services.yml up validation-service
|
|
|
|
# All Services
|
|
docker compose -f docker-compose-services.yml build --no-cache && docker compose -f docker-compose-services.yml up
|
|
```
|
|
|
|
## Service Ports
|
|
- Auth Service: `http://localhost:8000`
|
|
- `/test/health` - Protected health check endpoint (requires authentication)
|
|
- `/test/ping` - Public ping endpoint
|
|
- Event Service: `http://localhost:8001`
|
|
- Validation Service: `http://localhost:8002`
|
|
|
|
## Development Notes
|
|
- Use clean build (--no-cache) when:
|
|
- Changing Dockerfile
|
|
- Updating dependencies
|
|
- Experiencing caching issues
|
|
- Use regular build (with cache) when:
|
|
- Only changing application code
|
|
- For faster development iterations
|
|
- Run in detached mode:
|
|
```bash
|
|
docker compose -f docker-compose-services.yml up -d auth-service
|
|
```
|
|
- Stop services:
|
|
```bash
|
|
docker compose -f docker-compose-services.yml down
|
|
```
|