MEC Recast — Server-Vorbereitung (vor Prod-DNS)
Was: Checklisten, Port-Matrix und Bootstrap-Skript, damit der Recast-Server vor dem Cutover von Vercel vorbereitet werden kann.
Warum: Montag zeigen qbeyond-Kunden-Domains auf Vercel; Recast-Ordner, Nginx-Maps und *.cockpit-os.de-Tests können parallel laufen, ohne Prod-Traffic umzuleiten.
Wer: Hosting-Partner (Recast), IT, Dev.
Wo: Recast-Root-Server; Dateien im Monorepo unter deployment-templates/v0-recast/ und scripts/.
Artefakte
| Datei | Zweck |
|---|---|
docs/RECAST-MEC-HOSTER-CHECKLIST.md | Copy-Paste für Hoster (Jan/Benedikt) |
mec-center-port-matrix.csv | Phase, Slug, Prod-Domain, Ports 3101+, cockpit-os-Hosts |
mec-center-recast-sync.manifest.tsv | 25 Center-Repos für GitHub-Sync (Suma ausgenommen — MEC-Austritt möglich) |
scripts/mec-recast-bootstrap-server-dirs.sh | /srv/docker/centers/* + Template-Stacks anlegen |
scripts/sync-recast-dedicated-to-center-repos.sh | Deploy-Dateien in Center-v0-Repos |
RECAST-DEPLOY-DEDICATED.md | Dedicated pro Center |
So testen (Dev / IT)
./scripts/mec-recast-bootstrap-server-dirs.sh --dry-run --phase rollout- Auf Recast (ohne
--dry-run): gleicher Befehl +--write-nginx-map - Ein Template-Stack:
curl http://127.0.0.1:3001/api/healthnachdocker compose up - Dedicated: erst nach grünem GHCR-Build im jeweiligen
smg-*-website-Repo
Erreichbarkeit *.cockpit-os.de vs. Container-Start
Nein — nicht nur durch up. Nach docker compose up antwortet die App auf 127.0.0.1:<APP_PORT> auf dem Recast-Server.
*.cockpit-os.de liegt bei SMG (nicht qbeyond). Viele Staging-Hosts zeigen bereits auf die Recast-IP — dann fehlt für den Browser meist nur noch:
- Nginx-Map Host → Port (
docs/RECAST-NGINX-HANDOFF-BENEDIKT.md, Map ausmec-recast-bootstrap-server-dirs.sh --write-nginx-map). - TLS für die Staging-Hosts (Certbot/Wildcard).
Kunden-Produktionsdomains (*.de aus qbeyond) sind getrennt: Montag oft noch Vercel; Recast-Cutover = A-Record auf Recast, nicht cockpit-os.de umziehen.
Smoke ohne Browser: ssh recast 'curl -sf http://127.0.0.1:3102/api/health'.
Ops-Skripte (Secrets, Server-.env)
| Schritt | Befehl |
|---|---|
| Register-Tokens Live-DB + TSV | pnpm mec-recast:sync-tokens |
Recast .env befüllen | pnpm mec-recast:remote-env |
| Stacks starten | MEC_RECAST_START=true pnpm mec-recast:remote-env --start |
TSV/Credentials: deployment/recast/ (gitignored).
Betrieb
- Prod-DNS: Erst A-Record auf Recast, wenn Vercel-Phase abgeschlossen (siehe Matrix
phase=vercel-montag). - Secrets: Nie ins Repo —
REVALIDATION_SECRET,frt_…, GHCR-Token nur auf dem Server. - Watchtower:
/srv/docker/templates/watchtower/— nur Container mit Labelwatchtower.enable=true.
Siehe auch
- MEC Multi-Center Runbook (4 Template-Stacks)
- Go-Live — MEC auf Recast
- v0 Recast Deploy
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/mec-recast-server-vorbereitung