meldestelle/config

Zentrale Konfigurationsverwaltung - Single Source of Truth

Version: 4.0.0 Datum: 15. September 2025 Status: ✅ Produktiv - Eliminiert 38+ Port-Redundanzen und 72+ Spring-Profile-Duplikate

🎯 Überblick

Das zentrale Konfigurationssystem eliminiert Redundanzen über das gesamte Meldestelle-Projekt und stellt sicher, dass alle Konfigurationswerte aus einer einzigen Quelle der Wahrheit stammen.

Vor der Zentralisierung (Problem)

Port 8082 war in 38+ Dateien dupliziert:
├── gradle.properties
├── docker-compose.services.yml
├── dockerfiles/services/ping-service/Dockerfile
├── scripts/test/integration-test.sh
├── config/monitoring/prometheus.dev.yml
└── ... 33 weitere Dateien!

Nach der Zentralisierung (Lösung)

Port 8082 einmalig in config/central.toml definiert:
├── config/central.toml              [SINGLE SOURCE OF TRUTH]
└── scripts/config-sync.sh sync      [Automatische Synchronisation]
    └── 38+ Dateien automatisch aktualisiert ✓

📁 Verzeichnisstruktur

config/
├── central.toml              # 🎯 MASTER-Konfigurationsdatei
├── README.md                 # 📖 Diese Dokumentation
├── .env.template            # 🔧 Environment-Variables Template (Legacy)
└── monitoring/              # 📊 Monitoring-Konfigurationen
    ├── prometheus.yml
    ├── prometheus.dev.yml
    └── grafana/

🛠️ Verwendung

Schnellstart

# 1. Aktuelle Konfiguration anzeigen
./scripts/config-sync.sh status

# 2. Alle Konfigurationen synchronisieren
./scripts/config-sync.sh sync

# 3. Konfiguration validieren
./scripts/config-sync.sh validate

Port ändern (Beispiel)

# 1. central.toml bearbeiten
vim config/central.toml

[ports]
ping-service = 8092  # Geändert von 8082

# 2. Alle abhängigen Dateien aktualisieren
./scripts/config-sync.sh sync

# ✅ Ergebnis: 38+ Dateien automatisch synchronisiert!

Spring Profile ändern

# 1. central.toml bearbeiten
[spring-profiles.defaults]
services = "production"  # Geändert von "docker"

# 2. Synchronisieren
./scripts/config-sync.sh sync

# ✅ Ergebnis: 72+ Profile-Referenzen automatisch aktualisiert!

📋 Konfigurationsbereiche

1. Ports - Eliminiert 38+ Redundanzen

[ports]
# Infrastructure Services
api-gateway = 8081
auth-server = 8087
monitoring-server = 8088

# Application Services
ping-service = 8082
members-service = 8083
horses-service = 8084
events-service = 8085
masterdata-service = 8086

# External Infrastructure
postgres = 5432
redis = 6379
consul = 8500
prometheus = 9090
grafana = 3000

Synchronisiert folgende Dateien:

• gradle.properties - Service-Port-Eigenschaften
• docker-compose*.yml - Port-Mappings und Environment-Variablen
• dockerfiles/*/Dockerfile - EXPOSE-Statements
• scripts/test/*.sh - Test-Endpunkt-URLs
• config/monitoring/*.yml - Prometheus-Targets
• Und 25+ weitere Dateien!

2. Spring Profiles - Eliminiert 72+ Duplikate

[spring-profiles]
default = "default"
development = "dev"
docker = "docker"
production = "prod"
test = "test"

[spring-profiles.defaults]
infrastructure = "default"    # Infrastructure Services
services = "docker"          # Application Services
clients = "dev"             # Client Applications

Synchronisiert folgende Dateien:

• Alle dockerfiles/*/Dockerfile - SPRING_PROFILES_ACTIVE Build-Args
• docker-compose*.yml - Spring-Profile Environment-Variablen
• docker/build-args/*.env - Build-Argument-Dateien
• Und 60+ weitere Referenzen!

3. Service Discovery - Standardisiert URLs

[services.ping-service]
name = "ping-service"
port = 8082
internal-host = "ping-service"
external-host = "localhost"
internal-url = "http://ping-service:8082"
external-url = "http://localhost:8082"
health-endpoint = "/actuator/health/readiness"
metrics-endpoint = "/actuator/prometheus"
info-endpoint = "/actuator/info"

🚀 Scripts und Automatisierung

scripts/config-sync.sh - Haupttool

# Alle Konfigurationen synchronisieren
./scripts/config-sync.sh sync

# Nur bestimmte Bereiche synchronisieren
./scripts/config-sync.sh gradle       # gradle.properties
./scripts/config-sync.sh compose      # Docker Compose files
./scripts/config-sync.sh env          # Environment files
./scripts/config-sync.sh docker-args  # Docker build arguments
./scripts/config-sync.sh monitoring   # Prometheus/Grafana config
./scripts/config-sync.sh tests        # Test scripts

# Status und Validierung
./scripts/config-sync.sh status       # Aktuelle Konfiguration anzeigen
./scripts/config-sync.sh validate     # TOML-Syntax validieren

# Hilfe
./scripts/config-sync.sh --help

🎯 Best Practices

✅ DO (Empfohlen)

# Vor Änderungen Status prüfen
./scripts/config-sync.sh status

# Nach Änderungen validieren
./scripts/config-sync.sh validate

# Regelmäßig synchronisieren
./scripts/config-sync.sh sync

# Backups vor wichtigen Änderungen
cp config/central.toml config/central.toml.backup

❌ DON'T (Vermeiden)

# ❌ Niemals direkte Datei-Bearbeitung
vim docker-compose.yml              # Änderungen gehen verloren!
vim gradle.properties              # Wird überschrieben!

# ✅ Stattdessen zentrale Konfiguration verwenden
vim config/central.toml
./scripts/config-sync.sh sync

🔍 Debugging und Troubleshooting

Häufige Probleme

Problem: Synchronisation schlägt fehl

# Lösung: Validierung prüfen
./scripts/config-sync.sh validate

# TOML-Syntax-Fehler beheben
vim config/central.toml

Problem: Inkonsistente Konfiguration

# Lösung: Status prüfen und re-synchronisieren
./scripts/config-sync.sh status
./scripts/config-sync.sh sync

Problem: Backup wiederherstellen

# Backups anzeigen
ls -la *.bak.*

# Wiederherstellen
cp gradle.properties.bak.20250915_103927 gradle.properties

Validierung

# Umfassende Validierung
./scripts/config-sync.sh validate

# Prüft:
# ✓ TOML-Syntax
# ✓ Duplicate Sections
# ✓ Port-Konflikte
# ✓ Ungültige Werte

🚀 Migration und Integration

Die zentrale Konfigurationsverwaltung ist rückwärtskompatibel und kann schrittweise eingeführt werden:

1. config/central.toml erstellen ✅
2. scripts/config-sync.sh ausführen ✅
3. Backups prüfen und validieren ✅
4. Entwickler-Workflow anpassen ✅

🎉 Mit der zentralen Konfigurationsverwaltung haben Sie einen wartungsfreundlichen, skalierbaren und fehlerresistenten Ansatz für die Verwaltung aller Konfigurationswerte in Ihrem Meldestelle-Projekt!