mocode-software/meldestelle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
fb1c1ee4ce
meldestelle/docs/06_Frontend/Logs/2026-02-02_Docker_Build_Troubleshooting.md
Stefan Mogeritsch 09b0b1a462 infra: clean up Keycloak configuration, enforce consistency in .env, and improve health checks 
Streamlined Keycloak configurations with defaults for development and production in `.env`. Added health checks and improved environment variable documentation with comments to differentiate local and server deployments. Ensured compatibility with pre-built registry images.
2026-03-06 11:23:24 +01:00

3.6 KiB
Raw Blame History

type status owner
Report ARCHIVED Frontend Expert

🧹 Troubleshooting Log: Frontend Docker Build & Runtime Config

Datum: 02.02.2026 Status: ⚠️ BLOCKED (Build Failure) Thema: Dockerisierung des KMP Frontends (JS/IR) mit Caddy und Runtime-Konfiguration.

1. Zielsetzung

Stabilisierung des Frontend-Deployments via Docker Compose.

  • Architektur: Single Page Application (SPA) served by Caddy.
  • Anforderung: "Build Once, Deploy Anywhere" -> Konfiguration (API URL) muss zur Laufzeit (Runtime) injiziert werden, nicht zur Build-Zeit.
  • Tech Stack: Kotlin 2.3.0, Gradle 9.2.1, Compose Multiplatform 1.10.0.

2. Implementierte Lösung (Code-Ebene)

Die Architektur für die Runtime-Konfiguration wurde erfolgreich implementiert:

  1. Kotlin (Config.kt, main.kt):
    • Die App lädt vor dem Start der UI eine config.json via window.fetch.
    • AppConfig wird in Koin registriert.
  2. Caddy (Caddyfile, config.json):
    • Caddy Webserver ersetzt Nginx.
    • Nutzt das templates Modul, um Environment-Variablen (API_BASE_URL) in die config.json zu rendern.
  3. Dockerfile:
    • Multi-Stage Build (Gradle -> Caddy).
    • Optimiertes Caching für Gradle 9.x.

3. Das Problem: Gradle Build Fehler

Der Build schlägt im Docker-Container (und teilweise lokal) fehl mit: PluginApplicationException: Failed to apply plugin class 'org.jetbrains.kotlin.gradle.targets.js.nodejs.NodeJsRootPlugin'. The Kotlin Gradle plugin was loaded multiple times in different subprojects...

Ursache

In einem Multi-Modul KMP-Projekt (Shell + Core Libraries) versuchen mehrere Module, die JavaScript-Umgebung (Node.js/Browser) zu konfigurieren.

  • Shell (meldestelle-portal): Benötigt browser() für Webpack/Distribution.
  • Libraries (core/*): Benötigen JS-Target für Kompilierung, nutzen teilweise npm() Abhängigkeiten (z.B. local-db für SQLite).
  • Konflikt: Gradle 9.x und das Kotlin-Plugin geraten in einen Race-Condition-Zustand, wenn das NodeJsRootPlugin transitiv mehrfach initialisiert wird.

4. Durchgeführte Versuche

Versuch Änderung Ergebnis Analyse
1. Basis alias(libs.plugins...) in allen Modulen. browser {} in allen Modulen. ❌ FAILED "Plugin loaded multiple times".
2. Library Mode Entfernen von browser {} aus allen Core-Modulen. Nur binaries.library(). ⚠️ SUCCESS (Lokal) / ❌ FAILED (Docker) Lokal: Warnung "JS Environment Not Selected". Docker: Trotzdem Fehler, vermutlich wegen npm() Dependency in local-db.
3. Explicit Browser Hinzufügen von minimalem browser { testTask { enabled = false } } in Libraries. ❌ FAILED Sofortiger "Plugin loaded multiple times" Fehler.
4. Plugin ID Nutzung von id("org.jetbrains.kotlin.multiplatform") statt alias. ❌ FAILED "Plugin not found" (Version Resolution via Catalog schlägt fehl).
5. Revert Zurück zu "Library Mode" (Versuch 2). ❌ FAILED Der Fehler bleibt hartnäckig im Docker-Build bestehen.

5. Nächste Schritte (Planung)

Das Problem liegt in der Gradle-Konfiguration der JS-Targets im Monorepo.

  1. Root-Level Node.js Konfiguration: Das NodeJsRootPlugin muss zwingend einmalig im Root-Projekt konfiguriert werden, um den Konflikt in den Submodulen zu lösen.
  2. Convention Plugin: Erstellung eines buildSrc oder conventions Plugins, das die JS-Konfiguration zentralisiert (apply(plugin = "kotlin-multiplatform")).
  3. Workaround: Explizites rootProject.plugins.apply(...) für das NodeJs-Plugin in der Root build.gradle.kts.

Dokumentiert durch Curator Agent.