docker-deploy.mdc

---
description: Docker und Deployment-Regeln
globs: Dockerfile,dockerfiles/**,*.yml,.github/**/*.yml
---

# Docker & Deployment

## Docker Build
- Multi-Stage Build: `builder` (kompiliert) → `runtime` (nur Node.js + dist)
- Base Image: `node:22.20.0-alpine`
- Shared-Paket wird nach `backend/dist/node_modules/@webmud3/shared` kopiert (kein npm Registry)
- Prod-Dependencies werden separat in `backend/dist/` installiert (`npm install --omit=dev`)

## Wichtige Docker-Umgebungsvariablen
```env
HOST=0.0.0.0
PORT=5000
TELNET_HOST=127.0.0.1
TELNET_PORT=23
TELNET_TLS=false
SOCKET_ROOT=/socket.io
SOCKET_TIMEOUT=900000
```

## CI/CD
- **Build & Test**: GitHub Action auf PRs gegen `develop`
- **Deploy to Azure**: GitHub Action auf Push zu `master`
- Azure Deployment kopiert `shared/dist` manuell nach `backend/dist/node_modules/@webmud3`

## Build-Reihenfolge
```
npm ci → npm run build:prod
  1. shared: tsc
  2. frontend: ng build --configuration=production
  3. backend: tsc
  4. postbuild: cpy frontend/dist → backend/dist/wwwroot/
```