4.5 KiB
AK-INFRA1 · Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer
| Typ | Dev (Ops/Infra — typ:external) |
| Owner | Akeshan |
| Phase | P1-Querschnitt (Infra-Schiene, kein Code-Modul) |
| Cycle/Fenster | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| Status | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
EXT-06(Hetzner-Projekt HiveGrid: S3 + Token + DEK-Master-Key) - Blocks: CI/Gates, alle Deploys (ohne Staging kein Demo, kein Gate-Beweis)
- Läuft parallel zu: Raffaels
R-P1a/R-P1b/R-P1c— reines Ops, kein Code-Konflikt (Grobstruktur: Raffael Code SOLO ‖ Akeshan Infra). Keine Schema-Berührung. - Konflikt-Risiko: keines.
Was wir bauen
Die lauffähige Staging-Umgebung auf der Hetzner/Coolify-Schiene (Infra-Stack ADR-009/010): staging-app + staging-api auf staging-1, öffentlich erreichbar aber gehärtet (noindex, HMAC-geschützt), plus die Coolify-managed Datenbank-Schicht (Postgres, Redis, PgBouncer). Das ist das Deploy-Ziel, gegen das alle Folge-Tickets ausrollen und die W1-Gates beweisen.
Definition of Done
staging-app+staging-apilive —/healthz200 + Coolifyrunning:healthy. noindex implementiert (greift mit nächstem main-Deploy); HMAC bewusst zurückgestellt (Owner-Entscheidung 19.06., s.u.)- Coolify-managed Postgres + Redis + PgBouncer erreichbar — Postgres/Redis Coolify
running:healthy, pooled DB-Pfad via/readyz200 belegt - Deploy-Pipeline grün (CI rollt gegen Staging aus) — Live-Revision =
main-Commitb8fff6fe
Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael)
Live verifiziert (Coolify-API + HTTP):
hivegrid-web,hivegrid-api,worker-general=running:healthy;hivegrid-staging-postgres+hivegrid-staging-redis=running:healthy.staging-web.hivegrid.de/healthz+/readyz= 200 (ready→ Postgres über PgBouncer erreichbar),staging-api.hivegrid.deebenso. TLS gültig (HSTS).- Deploy-Pipeline rollt
mainaus (Live-Revb8fff6fe= echter main-Commit). - PgBouncer hat keinen eigenen Coolify-Resource-UUID (vermutlich Sidecar/Teil der PG-URL); der pooled Pfad ist über
/readyzaber bewiesen.
Härtung (noindex) — LIVE auf Staging (Deploy fe1d75b1, verifiziert):
entry.server.tsxsetztX-Robots-Tag: noindex, nofollowauf jeder SSR-HTML-Antwort, wennWEB_NOINDEX=true(utils/seo/noindex.server.ts-Gate).WEB_NOINDEX=trueauf staging-web in Coolify gesetzt. Live verifiziert:GET /login→x-robots-tag: noindex, nofollow. Das ist der verlässliche noindex-Mechanismus (Suchmaschinen respektieren ihn pro Seite).- robots.txt bleibt statisch (
public/robots.txt, allow-all, env-unabhängig). Hinweis: Der dynamischeother-routes.server-Pfad greift im Prod-Server nicht (auch das bestehende/sitemap.xml302't dort) — env-abhängige robots.txt wäre also wirkungslos gewesen; derX-Robots-Tag-Header erzwingt den noindex ohnehin. Dasother-routes/sitemap-302-Verhalten ist ein separater, vorbestehender Befund (kein INFRA1-Blocker).
Entscheidung 2026-06-20 (Owner) — Staging-Access-Gate (HMAC/Edge-Basic-Auth) bewusst DEFERRED: Kein
Edge-Schutz für Staging nötig fürs Erste. Begründung: Staging-App liegt hinter Login (Root → 302 /login,
verifiziert), X-Robots-Tag: noindex, nofollow aktiv (keine Suchmaschinen-Indexierung), keine echten
Kundendaten auf Staging. Ein Edge-Basic-Auth (wie staging.mitapp.de) bleibt ein optionaler Folgeschritt,
falls Staging später öffentlich-sensibler wird — nicht Teil dieses Tickets. Die DoD-Formulierung
„HMAC-geschützt" gilt damit als bewusst aus dem W1-Scope genommen.
Status: DoD erfüllt — 100 % (W1-Scope). Staging live: web/api /readyz 200 (Migration
UserSession+TrustedDevice angewandt), Postgres/Redis/PgBouncer healthy, CI-Pipeline grün, noindex aktiv.
Staging-Access-Gate bewusst deferred (s.o.). Selbst machbar offen: 0. Ticket auf Done (Plane). Owner: Raffael.
Warum
Ohne Staging + DB-Schicht kein Deploy, kein CI-Gate, keine Noah-Demo. Sessions (R-P2a) brauchen Postgres als Source-of-Truth + Redis-Cache (AD-4); PgBouncer für Connection-Pooling unter RLS (SET LOCAL app.tenant_id pro Transaktion).
Quellen (granular)
EXTERNALS-CHECKLISTE.md→ C3/C4 (Staging + Coolify-DB)project_infra_stack(Memory) → ADR-009/010, Hetzner+Coolify+CloudflareROADMAP.md→ Phase 1 (lauffähige Codebasis)- abhängig:
EXT-06(S3 + DEK-Master-Key)