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.
This commit is contained in:
2026-01-03 09:12:35 +00:00
parent 82106cf636
commit 62d03e24a4

View File

@@ -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 <service-name>` 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!