docs: enhance local dev docs, update Docker Compose, and archive old journals

Added Mailpit setup and updated Keycloak configuration in local development runbooks. Improved Docker Compose stability with updated service dependencies and configurations. Archived outdated journal entries and documents for better organization.
This commit is contained in:
2026-01-20 14:00:09 +01:00
parent 5dc8f18201
commit 46361185d0
56 changed files with 596 additions and 1832 deletions
@@ -1,36 +1,10 @@
---
type: Journal
status: ACTIVE
owner: Infrastructure & DevOps Engineer
last_update: 2026-01-15
status: ARCHIVED
owner: DevOps Engineer
last_update: 2026-01-20
---
# Session Log: Infrastructure Zipkin Setup
# Zipkin Setup (17.01.2026)
## Zusammenfassung
In dieser Session wurde die Infrastruktur um Distributed Tracing mit **Zipkin** erweitert, um Latenzanalysen in der Microservice-Architektur zu ermöglichen.
## Durchgeführte Änderungen
### 1. Docker Compose (`docker-compose.yaml`)
* **Neuer Service `zipkin`:**
* Image: `openzipkin/zipkin:3`
* Port: `9411`
* Network Alias: `zipkin`
* **Service Integration:**
* Die Services `api-gateway`, `ping-service`, `entries-service`, `results-service` und `scheduling-service` wurden konfiguriert, um Tracing-Daten an Zipkin zu senden.
* Umgebungsvariablen hinzugefügt:
* `MANAGEMENT_ZIPKIN_TRACING_ENDPOINT`
* `MANAGEMENT_TRACING_SAMPLING_PROBABILITY`
### 2. Dokumentation
* Neue Referenz-Dokumentation erstellt: `docs/07_Infrastructure/Reference/zipkin.md`.
* Enthält Konfigurationsdetails und Troubleshooting-Hinweise.
## Betroffene Dateien
* `docker-compose.yaml`
* `docs/07_Infrastructure/Reference/zipkin.md`
## Nächste Schritte
* Backend-Developer müssen sicherstellen, dass die Micrometer-Tracing-Dependencies (`micrometer-tracing-bridge-brave`, `zipkin-reporter-brave`) im Build vorhanden sind.
* Neustart der Umgebung mit `docker compose up -d`.
**MOVED:** This file has been archived to `_archive/2026-01-17_Infrastructure_Zipkin_Setup.md`.