Skip to main content

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​

DateiZweck
docs/RECAST-MEC-HOSTER-CHECKLIST.mdCopy-Paste für Hoster (Jan/Benedikt)
mec-center-port-matrix.csvPhase, Slug, Prod-Domain, Ports 3101+, cockpit-os-Hosts
mec-center-recast-sync.manifest.tsv25 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.shDeploy-Dateien in Center-v0-Repos
RECAST-DEPLOY-DEDICATED.mdDedicated pro Center

So testen (Dev / IT)​

  1. ./scripts/mec-recast-bootstrap-server-dirs.sh --dry-run --phase rollout
  2. Auf Recast (ohne --dry-run): gleicher Befehl + --write-nginx-map
  3. Ein Template-Stack: curl http://127.0.0.1:3001/api/health nach docker compose up
  4. 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:

  1. Nginx-Map Host → Port (docs/RECAST-NGINX-HANDOFF-BENEDIKT.md, Map aus mec-recast-bootstrap-server-dirs.sh --write-nginx-map).
  2. 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)​

SchrittBefehl
Register-Tokens Live-DB + TSVpnpm mec-recast:sync-tokens
Recast .env befüllenpnpm mec-recast:remote-env
Stacks startenMEC_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 Label watchtower.enable=true.

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/developer-guide/mec-recast-server-vorbereitung