# =================================================================== # Meldestelle Docker Development Makefile # Convenient commands for managing containerized development workflow # =================================================================== .PHONY: help dev-up dev-down dev-restart dev-logs build clean test .PHONY: services-up services-down services-restart services-logs .PHONY: clients-up clients-down clients-restart clients-logs .PHONY: prod-up prod-down prod-restart prod-logs .PHONY: infrastructure-up infrastructure-down infrastructure-logs .PHONY: dev-tools-up dev-tools-down status health-check logs shell env-template dev-info clean-all build-service build-client .ONESHELL: # Choose docker compose CLI (prefers new plugin) DOCKER_COMPOSE_PLUGIN := $(shell docker compose version >/dev/null 2>&1 && echo 1 || echo 0) DOCKER_COMPOSE_LEGACY := $(shell command -v docker-compose >/dev/null 2>&1 && echo 1 || echo 0) ifeq ($(DOCKER_COMPOSE_PLUGIN),1) COMPOSE = docker compose else ifeq ($(DOCKER_COMPOSE_LEGACY),1) COMPOSE = docker-compose else COMPOSE = docker compose endif # 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 (simplified: base compose only) @echo "โš™๏ธ Starting services (simplified setup using docker-compose.yml only)..." $(COMPOSE) -f docker-compose.yml up -d @echo "โœ… Services started (based on docker-compose.yml)" services-down: ## Stop application services (simplified) $(COMPOSE) -f docker-compose.yml down services-restart: ## Restart application services @$(MAKE) services-down @$(MAKE) services-up services-logs: ## Show application services logs (simplified) $(COMPOSE) -f docker-compose.yml logs -f clients-up: ## Start client applications (simplified using base compose) @echo "๐Ÿ’ป Starting client applications (simplified)..." $(COMPOSE) -f docker-compose.yml up -d @echo "โœ… Client applications started (docker-compose.yml)" clients-down: ## Stop client applications (simplified) $(COMPOSE) -f docker-compose.yml down clients-restart: ## Restart client applications @$(MAKE) clients-down @$(MAKE) clients-up clients-logs: ## Show client application logs (simplified) $(COMPOSE) -f docker-compose.yml logs -f # =================================================================== # Production Commands # =================================================================== prod-up: ## Start production environment (simplified) @echo "๐Ÿš€ Starting production environment (simplified)..." @echo "โš ๏ธ Make sure environment variables are properly set!" $(COMPOSE) -f docker-compose.yml up -d @echo "โœ… Production environment started (docker-compose.yml)" prod-down: ## Stop production environment (simplified) $(COMPOSE) -f docker-compose.yml down prod-restart: ## Restart production environment @$(MAKE) prod-down @$(MAKE) prod-up prod-logs: ## Show production logs (simplified) $(COMPOSE) -f docker-compose.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 30 @echo "โœ… Running test suite..." ./gradlew test @$(MAKE) infrastructure-down 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 60 @echo "โœ… Running e2e test suite..." ./gradlew :client:web-app:jsTest @$(MAKE) dev-down # =================================================================== # 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"