StefanMoCoAt
8e932758a7
Datei: .junie/guidelines/technology-guides/docker/docker-development.md Vorher: - 194 Zeilen - last_updated: 2025-09-15 - ~10 dokumentierte Befehle - Falsche Befehlsnamen (service-build statt build-service) - Falscher Port (8080 statt 8081) Nachher: - 756 Zeilen - last_updated: 2025-11-11 - ~50+ dokumentierte Befehle - Korrekte Befehlsnamen - Korrekte Ports Neue Sektionen: 24 Haupt-Sektionen gefunden Korrigierte Dateien (API Gateway Port 8080 -> 8081): 1. infrastructure/gateway/README-INFRA-GATEWAY.md - 6 Stellen korrigiert (Docker-Befehle, Kubernetes, curl) 2. infrastructure/gateway/src/main/resources/openapi/documentation.yaml - 1 Server-URL korrigiert 3. infrastructure/README-INFRASTRUCTURE.md - 4 Stellen korrigiert (Prometheus, Kubernetes, curl) 4. services/masterdata/README-MASTERDATA.md - 3 curl Befehle korrigiert 5. .junie/guidelines/technology-guides/docker/docker-production.md - 1 Nginx upstream korrigiert 6. .junie/guidelines/technology-guides/docker/docker-monitoring.md - 1 Prometheus target korrigiert NICHT korrigiert (korrekt auf Port 8080): - Keycloak Health-Check (intern 8080, extern 8180) - Test-Konfigurationen mit Keycloak issuer-uri - Generische SERVICE_PORT Beispiele Gesamt: 16 Korrekturen in 6 Dateien
425 lines
17 KiB
Makefile
425 lines
17 KiB
Makefile
# ===================================================================
|
||
# Meldestelle Docker Development Makefile
|
||
# Optimierte Befehle für containerised Entwicklung-Workflows
|
||
# ===================================================================
|
||
|
||
# ===================================================================
|
||
# PHONY Target Declarations
|
||
# ===================================================================
|
||
.PHONY: help
|
||
.PHONY: dev-up dev-down dev-restart dev-logs dev-info dev-tools-up dev-tools-down
|
||
.PHONY: infrastructure-up infrastructure-down infrastructure-logs
|
||
.PHONY: services-up services-down services-restart services-logs
|
||
.PHONY: clients-up clients-down clients-restart clients-logs
|
||
.PHONY: full-up full-down full-restart full-logs
|
||
.PHONY: prod-up prod-down prod-restart prod-logs
|
||
.PHONY: env-setup env-dev env-prod env-staging env-test validate env-template
|
||
.PHONY: build build-service build-client clean clean-all
|
||
.PHONY: test test-e2e
|
||
.PHONY: status health-check logs shell
|
||
.PHONY: versions-show versions-update docker-sync docker-validate docker-compose-gen hooks-install
|
||
|
||
.ONESHELL:
|
||
|
||
# Modern Docker Compose CLI (plugin-based)
|
||
# Defaults to 'docker compose' as the legacy standalone tool is deprecated
|
||
COMPOSE = docker compose
|
||
|
||
# Default target
|
||
.DEFAULT_GOAL := help
|
||
help: ## Show this help message
|
||
@echo "Meldestelle Docker Development Commands"
|
||
@echo "======================================"
|
||
@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
|
||
|
||
# ===================================================================
|
||
# Development Workflow Commands
|
||
# ===================================================================
|
||
|
||
dev-up: ## Start development environment (single compose)
|
||
@echo "🚀 Starting development environment..."
|
||
$(COMPOSE) -f docker-compose.yml up -d
|
||
@$(MAKE) dev-info
|
||
|
||
dev-down: ## Stop development environment
|
||
@echo "🛑 Stopping development environment..."
|
||
$(COMPOSE) -f docker-compose.yml down
|
||
|
||
dev-restart: ## Restart full development environment
|
||
@$(MAKE) dev-down
|
||
@$(MAKE) dev-up
|
||
|
||
dev-logs: ## Show logs for all development services
|
||
$(COMPOSE) -f docker-compose.yml logs -f
|
||
|
||
# ===================================================================
|
||
# Layer-specific Commands
|
||
# ===================================================================
|
||
|
||
infrastructure-up: ## Start only infrastructure services (postgres, redis, keycloak, consul)
|
||
@echo "🏗️ Starting infrastructure services..."
|
||
$(COMPOSE) -f docker-compose.yml up -d
|
||
@echo "✅ Infrastructure services started"
|
||
@echo "🗄️ PostgresQL: localhost:5432"
|
||
@echo "🔴 Redis: localhost:6379"
|
||
@echo "🔐 Keycloak: http://localhost:8180"
|
||
@echo "🧭 Consul: http://localhost:8500"
|
||
|
||
infrastructure-down: ## Stop infrastructure services
|
||
$(COMPOSE) -f docker-compose.yml down
|
||
|
||
infrastructure-logs: ## Show infrastructure logs
|
||
$(COMPOSE) -f docker-compose.yml logs -f
|
||
|
||
services-up: ## Start application services (infrastructure + microservices)
|
||
@echo "⚙️ Starting application services..."
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml up -d
|
||
@echo "✅ Application services started"
|
||
@echo "🔗 Gateway: http://localhost:8081"
|
||
@echo "🏓 Ping Service: http://localhost:8082"
|
||
@echo "👥 Members Service: http://localhost:8083"
|
||
@echo "🐎 Horses Service: http://localhost:8084"
|
||
@echo "🎯 Events Service: http://localhost:8085"
|
||
@echo "📊 Master Service: http://localhost:8086"
|
||
|
||
services-down: ## Stop application services
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml down
|
||
|
||
services-restart: ## Restart application services
|
||
@$(MAKE) services-down
|
||
@$(MAKE) services-up
|
||
|
||
services-logs: ## Show application services logs
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml logs -f
|
||
|
||
clients-up: ## Start client applications (infrastructure + clients)
|
||
@echo "💻 Starting client applications..."
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.clients.yml up -d
|
||
@echo "✅ Client applications started"
|
||
@echo "🌐 Web App: http://localhost:4000"
|
||
@echo "🔐 Auth Server: http://localhost:8087"
|
||
@echo "📈 Monitoring: http://localhost:8088"
|
||
|
||
clients-down: ## Stop client applications
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.clients.yml down
|
||
|
||
clients-restart: ## Restart client applications
|
||
@$(MAKE) clients-down
|
||
@$(MAKE) clients-up
|
||
|
||
clients-logs: ## Show client application logs
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.clients.yml logs -f
|
||
|
||
# ===================================================================
|
||
# Full System Commands
|
||
# ===================================================================
|
||
|
||
full-up: ## Start complete system (infrastructure + services + clients)
|
||
@echo "🚀 Starting complete Meldestelle system..."
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml -f docker-compose.clients.yml up -d
|
||
@echo "✅ Complete system started"
|
||
@echo ""
|
||
@echo "🌐 Frontend & APIs:"
|
||
@echo " Web App: http://localhost:4000"
|
||
@echo " API Gateway: http://localhost:8081"
|
||
@echo ""
|
||
@echo "🔧 Infrastructure:"
|
||
@echo " PostgresQL: localhost:5432"
|
||
@echo " Redis: localhost:6379"
|
||
@echo " Keycloak: http://localhost:8180"
|
||
@echo " Consul: http://localhost:8500"
|
||
@echo " Prometheus: http://localhost:9090"
|
||
@echo " Grafana: http://localhost:3000"
|
||
@echo ""
|
||
@echo "⚙️ Microservices:"
|
||
@echo " Ping Service: http://localhost:8082"
|
||
@echo " Members Service: http://localhost:8083"
|
||
@echo " Horses Service: http://localhost:8084"
|
||
@echo " Events Service: http://localhost:8085"
|
||
@echo " Master Service: http://localhost:8086"
|
||
@echo " Auth Server: http://localhost:8087"
|
||
@echo " Monitoring: http://localhost:8088"
|
||
|
||
full-down: ## Stop complete system
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml -f docker-compose.clients.yml down
|
||
|
||
full-restart: ## Restart complete system
|
||
@$(MAKE) full-down
|
||
@$(MAKE) full-up
|
||
|
||
full-logs: ## Show all system logs
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml -f docker-compose.clients.yml logs -f
|
||
|
||
# ===================================================================
|
||
# SSoT Developer UX (optional helpers)
|
||
# ===================================================================
|
||
|
||
# Show current centralized versions from docker/versions.toml
|
||
versions-show: ## Show centralized versions (docker/versions.toml)
|
||
@bash scripts/docker-versions-update.sh show
|
||
|
||
# Update a single version key and sync env files (usage: make versions-update key=gradle value=9.1.0)
|
||
versions-update: ## Update one key in versions.toml and sync env files (key=<k> value=<v>)
|
||
@if [ -z "$(key)" ] || [ -z "$(value)" ]; then \
|
||
echo "Usage: make versions-update key=<key> value=<version>"; \
|
||
echo "Keys: gradle java node nginx alpine prometheus grafana keycloak app-version spring-profiles-default spring-profiles-docker"; \
|
||
exit 1; \
|
||
fi
|
||
@bash scripts/docker-versions-update.sh update $(key) $(value)
|
||
|
||
# Sync versions.toml into docker/build-args/*.env
|
||
docker-sync: ## Sync versions.toml -> build-args/*.env
|
||
@bash scripts/docker-versions-update.sh sync
|
||
|
||
# Generate all compose files for selected environment (ENV=development|production|testing)
|
||
ENV ?= development
|
||
|
||
docker-compose-gen: ## Generate docker-compose files from SSoT (ENV=development|production|testing)
|
||
@bash scripts/generate-compose-files.sh all $(ENV)
|
||
|
||
# Run full Docker SSoT validation
|
||
docker-validate: ## Validate SSoT (dockerfiles, compose, ports, build-args, drift)
|
||
@bash scripts/validate-docker-consistency.sh all
|
||
|
||
# Install optional pre-commit hook for SSoT guard
|
||
hooks-install: ## Install pre-commit SSoT guard hook into .git/hooks/pre-commit
|
||
@mkdir -p .git/hooks
|
||
@cp scripts/git-hooks/pre-commit-ssot .git/hooks/pre-commit
|
||
@chmod +x .git/hooks/pre-commit
|
||
@echo "✅ Installed .git/hooks/pre-commit (SSoT guard)"
|
||
|
||
# ===================================================================
|
||
# Environment Configuration Commands
|
||
# ===================================================================
|
||
|
||
env-setup: ## Show environment setup instructions
|
||
@echo "🔧 Umgebungskonfiguration - Environment Setup"
|
||
@echo "=============================================="
|
||
@echo ""
|
||
@echo "Verfügbare Umgebungen:"
|
||
@echo " make env-dev - Entwicklungsumgebung"
|
||
@echo " make env-prod - Produktionsumgebung"
|
||
@echo " make env-staging - Staging-Umgebung"
|
||
@echo " make env-test - Testumgebung"
|
||
@echo ""
|
||
@echo "Aktuelle Konfiguration:"
|
||
@ls -la .env 2>/dev/null || echo " Keine .env Datei gefunden - führe 'make env-dev' aus"
|
||
|
||
env-dev: ## Switch to development environment
|
||
@echo "🔧 Switching to development environment..."
|
||
@ln -sf config/.env.dev .env
|
||
@echo "✅ Development environment activated (.env -> config/.env.dev)"
|
||
@echo "Debug mode: enabled, CORS: permissive, Logging: verbose"
|
||
|
||
env-prod: ## Switch to production environment
|
||
@echo "🔧 Switching to production environment..."
|
||
@ln -sf config/.env.prod .env
|
||
@echo "✅ Production environment activated (.env -> config/.env.prod)"
|
||
@echo "⚠️ WICHTIG: Überprüfen Sie alle CHANGE_ME Werte in .env!"
|
||
|
||
env-staging: ## Switch to staging environment
|
||
@echo "🔧 Switching to staging environment..."
|
||
@ln -sf config/.env.staging .env
|
||
@echo "✅ Staging environment activated (.env -> config/.env.staging)"
|
||
@echo "Production-like settings with moderate resources"
|
||
|
||
env-test: ## Switch to test environment
|
||
@echo "🔧 Switching to test environment..."
|
||
@ln -sf config/.env.test .env
|
||
@echo "✅ Test environment activated (.env -> config/.env.test)"
|
||
@echo "Optimized for automated testing with alternative ports"
|
||
|
||
validate: ## Validate Docker Compose configuration and environment
|
||
@echo "🔍 Validating configuration..."
|
||
@if [ ! -f .env ]; then echo "❌ No .env file found! Run 'make env-dev' first."; exit 1; fi
|
||
@echo "✅ Environment file exists"
|
||
@$(COMPOSE) config --quiet && echo "✅ Docker Compose configuration is valid" || echo "❌ Docker Compose configuration has errors"
|
||
@echo "✅ Validation completed"
|
||
|
||
# ===================================================================
|
||
# Production Commands
|
||
# ===================================================================
|
||
|
||
prod-up: ## Start production environment
|
||
@echo "🚀 Starting production environment..."
|
||
@echo "⚠️ Make sure environment variables are properly set!"
|
||
@if [ ! -f .env ]; then echo "❌ No .env file found! Run 'make env-prod' first."; exit 1; fi
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml up -d
|
||
@echo "✅ Production environment started"
|
||
|
||
prod-down: ## Stop production environment
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml down
|
||
|
||
prod-restart: ## Restart production environment
|
||
@$(MAKE) prod-down
|
||
@$(MAKE) prod-up
|
||
|
||
prod-logs: ## Show production logs
|
||
$(COMPOSE) -f docker-compose.yml -f docker-compose.services.yml logs -f
|
||
|
||
# ===================================================================
|
||
# Development Tools
|
||
# ===================================================================
|
||
|
||
dev-tools-up: ## Info: development tool containers were removed (use local tools instead)
|
||
@echo "ℹ️ Development tool containers are not part of the simplified setup."
|
||
@echo "Use your local tools instead (e.g., pgAdmin, TablePlus, DBeaver, RedisInsight)."
|
||
@echo "Connection hints:"
|
||
@echo " PostgresQL: localhost:5432 (user/password per .env or defaults)"
|
||
@echo " Redis: localhost:6379"
|
||
@echo " Consul: http://localhost:8500"
|
||
@echo " Keycloak: http://localhost:8180"
|
||
|
||
dev-tools-down: ## Info: nothing to stop for dev tools in simplified setup
|
||
@echo "ℹ️ No dev-tool containers to stop in the simplified setup."
|
||
|
||
# ===================================================================
|
||
# Build and Maintenance Commands
|
||
# ===================================================================
|
||
|
||
build: ## Build all custom Docker images (simplified)
|
||
@echo "🔨 Building all custom Docker images (using docker-compose.yml)..."
|
||
$(COMPOSE) -f docker-compose.yml build --no-cache
|
||
|
||
build-service: ## Build specific service (usage: make build-service SERVICE=auth-server)
|
||
@test -n "$(SERVICE)" || (echo "❌ SERVICE parameter required. Usage: make build-service SERVICE=auth-server"; exit 1)
|
||
@echo "🔨 Building $(SERVICE)..."
|
||
$(COMPOSE) -f docker-compose.yml build --no-cache $(SERVICE)
|
||
|
||
build-client: ## Build specific client (usage: make build-client CLIENT=web-app)
|
||
@test -n "$(CLIENT)" || (echo "❌ CLIENT parameter required. Usage: make build-client CLIENT=web-app"; exit 1)
|
||
@echo "🔨 Building $(CLIENT)..."
|
||
$(COMPOSE) -f docker-compose.yml build --no-cache $(CLIENT)
|
||
|
||
clean: ## Clean up Docker resources
|
||
@echo "🧹 Cleaning up Docker resources..."
|
||
docker system prune -f
|
||
docker volume prune -f
|
||
docker network prune -f
|
||
@echo "✅ Cleanup completed"
|
||
|
||
clean-all: ## Clean up all Docker resources (including images)
|
||
@echo "🧹 Cleaning up all Docker resources..."
|
||
docker system prune -af --volumes
|
||
@echo "✅ Complete cleanup finished"
|
||
|
||
# ===================================================================
|
||
# Monitoring and Debugging Commands
|
||
# ===================================================================
|
||
|
||
status: ## Show status of all containers
|
||
@echo "📊 Container Status:"
|
||
$(COMPOSE) -f docker-compose.yml ps
|
||
|
||
health-check: ## Check health of core infrastructure services
|
||
@echo "🏥 Health Check Results:"
|
||
@echo "========================"
|
||
@$(COMPOSE) ps
|
||
@echo "-- Postgres --"
|
||
@$(COMPOSE) exec -T postgres pg_isready -U meldestelle -d meldestelle >/dev/null \
|
||
&& echo "PostgresQL: ✅ Ready" || echo "PostgresQL: ❌ Not ready"
|
||
@echo "-- Redis --"
|
||
@$(COMPOSE) exec -T redis redis-cli ping | grep -q PONG \
|
||
&& echo "Redis: ✅ PONG" || echo "Redis: ❌ Not responding"
|
||
@echo "-- Consul --"
|
||
@curl -sf http://localhost:8500/v1/status/leader >/dev/null \
|
||
&& echo "Consul: ✅ Leader elected" || echo "Consul: ❌ Not accessible"
|
||
@echo "-- Keycloak --"
|
||
@curl -sf http://localhost:8180/health/ready >/dev/null \
|
||
&& echo "Keycloak: ✅ Ready" || echo "Keycloak: ❌ Not accessible"
|
||
|
||
logs: ## Show logs for specific service (usage: make logs SERVICE=postgres)
|
||
@test -n "$(SERVICE)" || (echo "❌ SERVICE parameter required. Usage: make logs SERVICE=postgres"; exit 1)
|
||
$(COMPOSE) logs -f $(SERVICE)
|
||
|
||
shell: ## Open shell in specific container (usage: make shell SERVICE=postgres)
|
||
@test -n "$(SERVICE)" || (echo "❌ SERVICE parameter required. Usage: make shell SERVICE=postgres"; exit 1)
|
||
$(COMPOSE) exec $(SERVICE) sh
|
||
|
||
# ===================================================================
|
||
# Testing Commands
|
||
# ===================================================================
|
||
|
||
test: ## Run integration tests
|
||
@echo "🧪 Running integration tests..."
|
||
@$(MAKE) infrastructure-up
|
||
@echo "⏳ Waiting for services to be ready..."
|
||
@sleep 10
|
||
@$(MAKE) health-check || true
|
||
@echo "✅ Running test suite..."
|
||
@./gradlew test || (echo "❌ Tests failed"; $(MAKE) infrastructure-down; exit 1)
|
||
@$(MAKE) infrastructure-down
|
||
@echo "✅ Integration tests completed successfully"
|
||
|
||
test-e2e: ## Run end-to-end tests with full environment
|
||
@echo "🧪 Running end-to-end tests..."
|
||
@$(MAKE) dev-up
|
||
@echo "⏳ Waiting for full environment to be ready..."
|
||
@sleep 15
|
||
@$(MAKE) health-check || true
|
||
@echo "✅ Running e2e test suite..."
|
||
@./gradlew :client:web-app:jsTest || (echo "❌ E2E tests failed"; $(MAKE) dev-down; exit 1)
|
||
@$(MAKE) dev-down
|
||
@echo "✅ E2E tests completed successfully"
|
||
|
||
# ===================================================================
|
||
# Information and Help
|
||
# ===================================================================
|
||
|
||
dev-info: ## Show development environment information
|
||
@echo ""
|
||
@echo "🚀 Meldestelle Development Environment Ready!"
|
||
@echo "============================================="
|
||
@echo ""
|
||
@echo "🧭 Service Discovery:"
|
||
@echo " Consul: http://localhost:8500"
|
||
@echo ""
|
||
@echo "🔐 Authentication:"
|
||
@echo " Keycloak: http://localhost:8180 (admin/admin by default)"
|
||
@echo ""
|
||
@echo "🗄️ Infrastructure:"
|
||
@echo " PostgresQL: localhost:5432 (default user: meldestelle)"
|
||
@echo " Redis: localhost:6379"
|
||
@echo ""
|
||
@echo "ℹ️ Tips: Use 'make health-check' to verify services, and 'make logs SERVICE=postgres' for logs."
|
||
@echo ""
|
||
|
||
env-template: ## Create .env template file
|
||
@echo "📝 Creating .env template..."
|
||
@cat > .env.template <<-'EOF'
|
||
# ===================================================================
|
||
# Meldestelle Environment Variables Template
|
||
# Copy to .env and customize for your environment
|
||
# ===================================================================
|
||
|
||
# Database Configuration
|
||
POSTGRES_USER=meldestelle
|
||
POSTGRES_PASSWORD=meldestelle
|
||
POSTGRES_DB=meldestelle
|
||
|
||
# Redis Configuration
|
||
REDIS_PASSWORD=
|
||
|
||
# Keycloak Configuration
|
||
KEYCLOAK_ADMIN=admin
|
||
KEYCLOAK_ADMIN_PASSWORD=admin
|
||
KC_DB=postgres
|
||
KC_DB_URL=jdbc:postgresql://postgres:5432/keycloak
|
||
KC_DB_USERNAME=meldestelle
|
||
KC_DB_PASSWORD=meldestelle
|
||
|
||
# JWT Configuration
|
||
JWT_SECRET=meldestelle-auth-secret-key-change-in-production
|
||
JWT_EXPIRATION=86400
|
||
|
||
# Monitoring Configuration
|
||
GF_SECURITY_ADMIN_USER=admin
|
||
GF_SECURITY_ADMIN_PASSWORD=admin
|
||
|
||
# Production URLs (for production environment)
|
||
KC_HOSTNAME=auth.meldestelle.at
|
||
GRAFANA_HOSTNAME=monitor.meldestelle.at
|
||
PROMETHEUS_HOSTNAME=metrics.meldestelle.at
|
||
EOF
|
||
@echo "✅ .env.template created"
|