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
+9 -29
View File
@@ -109,18 +109,11 @@ services:
aliases:
- "mailpit"
# --- IAM: Keycloak ---
# --- IAM: Keycloak (DEBUG MODE) ---
keycloak:
image: "meldestelle-keycloak:latest"
image: "quay.io/keycloak/keycloak:26.4"
container_name: "${PROJECT_NAME:-meldestelle}-keycloak"
restart: no
build:
context: "./config/docker/keycloak"
args:
KEYCLOAK_IMAGE_TAG: "${KEYCLOAK_IMAGE_TAG:-26.4}"
BUILD_DATE: "${DOCKER_BUILD_DATE}"
labels:
- "org.opencontainers.image.created=${DOCKER_BUILD_DATE}"
environment:
KC_BOOTSTRAP_ADMIN_USERNAME: "${KC_ADMIN_USERNAME:-kc-admin}"
KC_BOOTSTRAP_ADMIN_PASSWORD: "${KC_ADMIN_PASSWORD:-kc-password}"
@@ -134,36 +127,23 @@ services:
KC_PROXY_HEADERS: "xforwarded"
KC_HEALTH_ENABLED: "true"
KC_METRICS_ENABLED: "true"
# Mailpit Configuration
KC_SPI_EMAIL_TEMPLATE_PROVIDER: "freemarker"
KC_SPI_EMAIL_SENDER_PROVIDER: "default"
KC_SPI_EMAIL_SENDER_DEFAULT_HOST: "mailpit"
KC_SPI_EMAIL_SENDER_DEFAULT_PORT: "1025"
KC_SPI_EMAIL_SENDER_DEFAULT_FROM: "keycloak@meldestelle.local"
KC_LOG_LEVEL: "INFO"
ports:
- "${KC_PORT:-8180:8080}"
- "${KC_DEBUG_PORT:-9000:9000}"
depends_on:
postgres:
condition: "service_healthy"
redis:
condition: "service_healthy"
mailpit:
condition: "service_started"
volumes:
# Mount für den Import
- "./config/docker/keycloak:/opt/keycloak/data/import:Z"
profiles: [ "infra", "all" ]
command: "start --optimized --import-realm"
healthcheck:
test: [ "CMD-SHELL", "exec 3<>/dev/tcp/127.0.0.1/9000" ]
interval: "10s"
timeout: "5s"
retries: "5"
start_period: "60s"
# Import beim Start aktivieren
command: "start-dev --import-realm"
networks:
meldestelle-network:
aliases:
- "keycloak"
profiles: [ "infra", "all" ]
# ==========================================
# 2. BACKEND SERVICES (Spring Boot)
@@ -224,7 +204,7 @@ services:
postgres:
condition: "service_healthy"
keycloak:
condition: "service_healthy"
condition: "service_started" # Geändert auf started, da wir keinen Healthcheck haben
consul:
condition: "service_healthy"
redis:
@@ -287,7 +267,7 @@ services:
postgres:
condition: "service_healthy"
keycloak:
condition: "service_healthy"
condition: "service_started"
consul:
condition: "service_healthy"
redis: