meldestelle/README-ENV.md
stefan e7b18da45d refactor: Migrate from monolithic to modular architecture
1. **Docker-Compose für Entwicklung optimieren**
2. **Umgebungsvariablen für lokale Entwicklung**
3. **Service-Abhängigkeiten**
4. **Docker-Compose für Produktion**
5. **Dokumentation**
2025-07-24 14:20:48 +02:00

2.9 KiB

Umgebungsvariablen Setup - Zusammenfassung

Was wurde implementiert

Dieses Projekt wurde erfolgreich mit einer umfassenden Umgebungsvariablen-Konfiguration für die lokale Entwicklung ausgestattet.

1. Erstellte Dateien

  • .env - Zentrale Konfigurationsdatei mit allen erforderlichen Umgebungsvariablen
  • docs/development/environment-variables-de.md - Umfassende Dokumentation aller Umgebungsvariablen
  • validate-env.sh - Validierungsskript für die Umgebungskonfiguration

2. Aktualisierte Dateien

  • docker-compose.yml - Alle Services verwenden jetzt Umgebungsvariablen mit Fallback-Werten

3. Konfigurierte Services

Die folgenden Services sind vollständig konfiguriert:

  • PostgreSQL - Datenbank mit konfigurierbaren Zugangsdaten
  • Redis - Event Store und Cache mit separaten Konfigurationen
  • Keycloak - Authentifizierung mit konfigurierbaren Admin-Zugangsdaten
  • Kafka/Zookeeper - Messaging-System mit konfigurierbaren Parametern
  • Grafana - Monitoring mit konfigurierbaren Admin-Zugangsdaten
  • Prometheus - Metriken-Sammlung
  • Zipkin - Distributed Tracing

4. Umgebungsvariablen-Kategorien

  • Anwendungskonfiguration (API_HOST, API_PORT, etc.)
  • Datenbank-Konfiguration (DB_HOST, DB_PORT, DB_USER, etc.)
  • Redis-Konfiguration (Event Store und Cache)
  • Sicherheitskonfiguration (JWT_SECRET, API_KEY, etc.)
  • Keycloak-Konfiguration (Admin-Zugangsdaten, DB-Verbindung)
  • Service Discovery (Consul-Konfiguration)
  • Messaging (Kafka/Zookeeper-Konfiguration)
  • Monitoring (Grafana, Prometheus-Konfiguration)
  • Logging-Konfiguration (Log-Level, Request/Response-Logging)
  • CORS und Rate Limiting

Verwendung

Schnellstart

  1. Services starten:

    docker-compose up -d
    
  2. Konfiguration validieren:

    ./validate-env.sh
    
  3. Services überprüfen:

    docker-compose ps
    

Anpassungen

  • Bearbeiten Sie die .env-Datei für lokale Anpassungen
  • Verwenden Sie verschiedene Ports für mehrere Entwickler
  • Ändern Sie Passwörter für Produktionsumgebungen

Dokumentation

Vollständige Dokumentation finden Sie in:

  • docs/development/environment-variables-de.md

Sicherheitshinweise

⚠️ Wichtig:

  • Niemals Produktionsgeheimnisse in die Versionskontrolle einbinden
  • JWT_SECRET in der Produktion ändern
  • Starke Passwörter für Produktionsumgebungen verwenden
  • API-Schlüssel regelmäßig rotieren

Fehlerbehebung

Bei Problemen:

  1. Führen Sie ./validate-env.sh aus
  2. Überprüfen Sie die Logs mit docker-compose logs -f
  3. Validieren Sie die Konfiguration mit docker-compose config

Nächste Schritte

  • Testen Sie die Anwendung mit den neuen Umgebungsvariablen
  • Passen Sie die Werte nach Bedarf für Ihre Entwicklungsumgebung an
  • Erstellen Sie umgebungsspezifische .env-Dateien für verschiedene Stages