Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/AK-INFRA2.md
T

5.5 KiB

AK-INFRA2 · DNS + Wildcard-TLS + zentrale Dienste anbinden

Typ Dev (Ops/Infra — typ:external)
Owner Raffael (urspr. Akeshan; Umsetzung + Verifikation Raffael, s. Plane-Assignee)
Phase P1-Querschnitt (Infra-Schiene, kein Code-Modul)
Cycle/Fenster W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1
Status Done (Plane Done seit 2026-06-20; Audit-bestätigt 2026-07-16)

Abhängigkeiten & Parallelität

  • Blocked by: AK-INFRA1 (Staging + Coolify-Apps + DB müssen erst stehen)
  • Blocks: R-P2a (mCaptcha), AK-P4a (ClamAV), R-P11a (Meilisearch) — alle drei brauchen die per-ENV angebundenen Zentral-Dienste
  • Läuft parallel zu: Raffaels P1-Code — reines Ops, kein Code-Konflikt. Keine Schema-Berührung.
  • Konflikt-Risiko: keines.

Was wir bauen

Die Netzwerk-/TLS-Schicht und die Anbindung der zentral vorhandenen Dienste (Memory: Meilisearch/mCaptcha/ClamAV zentral verfügbar). Cloudflare-Wildcard-TLS *.hivegrid.de inkl. admin.- und staging.-Subdomains (Multi-Host-Topologie aus den URL-Schemata von R-P1a), plus per-ENV-Anbindung von Meili-scoped-Key, mCaptcha und ClamAV an die Apps.

Definition of Done

  • Meilisearch (scoped-Key) per ENV angebunden — MEILI_URL + MEILI_API_KEY auf web/api/worker gesetzt (Coolify, verifiziert 19.06.)
  • mCaptcha per ENV angebunden — MCAPTCHA_INSTANCE_URL/_ACCOUNT_SECRET/_SITEKEY_* + CAPTCHA_FAIL_OPEN gesetzt; live: captcha.saas-ctrl.com
  • ClamAV per ENV angebunden — CLAMAV_HOST (10.42.0.4, privates Netz) + CLAMAV_PORT gesetzt
  • TLS + Subdomains für Multi-Host-Architektur — Staging: staging-web/staging-api lösen auf, TLS gültig (HSTS). Prod (erledigt 20.06. via Prod-Rollout): app./api./admin./captcha./coolify.hivegrid.de lösen auf, alle mit gültigem TLS (app/api/captcha CF-proxied, admin/coolify Traefik+LE). Bewusst KEINE *-Wildcard, sondern explizite A-Records pro Subdomain — die ticket-doc selbst warnte vorm Wildcard-Fehlrouting; einzelne Records sind sauberer + zielgenau auf die Prod-IPs.

Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael)

Verifiziert (Coolify-ENV + Cloudflare-DNS via dig/API):

  • Zentral-Dienste mCaptcha/Meilisearch/ClamAV auf web/api/worker per ENV gebunden (3/3).
  • TLS auf Staging gültig (HSTS); staging-web/staging-api → A 46.225.5.93 (dns-only). Admin = staging-web (ADMIN_APP_HOST==WEB_APP_HOST) → kein eigener Host nötig.
  • Kein Wildcard *.hivegrid.de; app./admin./portal. lösen nicht auf (Prod offen).

Bewusst vertagt → Prod-Rollout (kommt direkt im Anschluss): Wildcard + echte Prod-Subdomains (app./admin./api./portal. → Prod-IPs). Ein Wildcard auf eine Staging-/Marketing-IP würde Prod- Subdomains fehlrouten, deshalb hier KEINE Records angelegt. Topologie-Überlegung (Raffael, 19.06.): Prod evtl. unter eigenem Hetzner-Account (saubere Trennung Staging/Prod) — betrifft dann DEK-Master-Key, Object-Storage-Bucket und v.a. die Erreichbarkeit der heute privat adressierten Zentral-Dienste (ClamAV 10.42.0.4, interne PG/Redis-URLs). Entscheidung + ggf. ADR beim Prod-Rollout.

Update 2026-06-20 — Prod-Subdomains live (DoD 4/4 erfüllt → 100 %): Mit dem Prod-Rollout (eigener Hetzner-Account + eigenes Coolify, ADR-024 / infra ADR-016) sind die echten Prod-Subdomains live mit TLS: app./api./admin.hivegrid.de (Apps), captcha.hivegrid.de (mCaptcha), coolify.hivegrid.de (Coolify-UI). Zentral-Dienste auf Prod neu angebunden (Meili/ClamAV/mCaptcha auf der worker-VM über das private Netz, nicht mehr 10.42.0.4). Voller Ablauf: docs/ops/prod-rollout-hivegrid.md.

Status: DoD 4/4 erfüllt — 100 %. Staging-Scope (W1) + Prod-Subdomains+TLS beide live. Selbst machbar offen: 0. (Estate-Doku im infra-Repo nachgezogen: README-DNS + ADR-016.)

Audit-Notiz (2026-07-16, Stand-Audit)

Drei-Quellen-Abgleich (Doc vs. Plane vs. Code/Live) — DoD 4/4 bestätigt, 100 %:

  • Live nachgemessen: app./api./admin./captcha./coolify.hivegrid.de lösen alle auf und antworten mit gültigem TLS; Staging-Hosts staging-app/staging-api/staging-admin → A 46.225.5.93, healthy.
  • ENV-Anbindung (Meili/mCaptcha/ClamAV): per Umsetzungs-Notiz 19.06. belegt; captcha.hivegrid.de live erreichbar. Keine Gegenindizien.
  • Plane: Status Done (20.06.), Kommentare deckungsgleich mit dieser Doc.
  • Korrigierter Drift: Status-Header stand fälschlich auf „geplant" (→ Done), Owner-Zeile präzisiert (Plane-Assignee Raffael).
  • Außerhalb Ticket-Scope notiert: portal.hivegrid.de hat bis heute keinen DNS-Record, staging-portal.hivegrid.de liefert ein ungültiges TLS-Cert (kein LE-Issuer) — gehört zum Portal-Rollout (VA-P26-Umfeld), nicht zu diesem Ticket. Ebenso offen: CAPTCHA_FAIL_OPEN=false in Coolify gemäß Hardening-Notiz 2026-07-12 (docs/ops/prod-rollout-hivegrid.md) verifizieren.

Warum

Die Multi-Host-Architektur (App/Admin/Portal getrennte Subdomains, R-P1a) braucht Wildcard-TLS. Die drei Zentral-Dienste sind harte Vorbedingungen: mCaptcha (Login ab 3. Fehlversuch), ClamAV (Upload-Scan), Meilisearch (Suche P11). Anbindung per ENV statt eigener Deployments (Dienste laufen zentral).

Quellen (granular)

  • AGENTS.md → Estate-Infrastruktur und zentrale Dienste
  • project_infra_stack (Memory) → Meilisearch/mCaptcha/ClamAV zentral vorhanden, Cloudflare
  • docs/INTEGRATION-CONTRACTS.md (URL-Schemata / Subdomains aus R-P1a)
  • abhängig: AK-INFRA1