From 62d03e24a4706699face3742c83675b769549935 Mon Sep 17 00:00:00 2001 From: Floke Date: Sat, 3 Jan 2026 09:12:35 +0000 Subject: [PATCH] docs(build): Add critical warning about volume mounts - Adds a prominent warning section to the migration guide. - Explains that local volume mounts (sideloading) will overwrite container code. - Explicitly states that Already up to date. on the host is mandatory before rebuilding to ensure changes are applied. This addresses a recurring debugging issue. --- BUILDER_APPS_MIGRATION.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/BUILDER_APPS_MIGRATION.md b/BUILDER_APPS_MIGRATION.md index 98f470c8..2b42a738 100644 --- a/BUILDER_APPS_MIGRATION.md +++ b/BUILDER_APPS_MIGRATION.md @@ -193,9 +193,18 @@ CMD ["node", "server.cjs"] --- -## 4. Docker Compose & Mounts +## 4. Docker Compose & Mounts (WICHTIGER PITFALL) -Beim Sideloading (Entwicklung ohne Rebuild) müssen **alle** Abhängigkeiten gemountet werden, nicht nur das Hauptskript. +**WARNUNG: Lokale Dateien überschreiben den Container-Code!** + +Wenn Sie `volumes` für das Sideloading verwenden (wie unten gezeigt), werden die Dateien aus Ihrem lokalen Verzeichnis direkt in den Container geladen. Das bedeutet: **Wenn Sie nicht `git pull` auf dem Host-System ausführen, bevor Sie den Container neu bauen, wird der Container weiterhin den alten, lokalen Code ausführen.** + +**Workflow:** +1. Änderungen im Git-Repository pushen (oder von einem Agent pushen lassen). +2. **`git pull` auf dem Host-System ausführen.** (Dieser Schritt ist entscheidend!) +3. `docker-compose up -d --build ` ausführen. + +Beim Sideloading müssen **alle** Abhängigkeiten gemountet werden, nicht nur das Hauptskript. **Wichtig:** Der Pfad zu `server.cjs` ändert sich durch die "Flat Structure" im Dockerfile!