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_KEYauf web/api/worker gesetzt (Coolify, verifiziert 19.06.) - mCaptcha per ENV angebunden —
MCAPTCHA_INSTANCE_URL/_ACCOUNT_SECRET/_SITEKEY_*+CAPTCHA_FAIL_OPENgesetzt; live:captcha.saas-ctrl.com - ClamAV per ENV angebunden —
CLAMAV_HOST(10.42.0.4, privates Netz) +CLAMAV_PORTgesetzt - TLS + Subdomains für Multi-Host-Architektur — Staging:
staging-web/staging-apilösen auf, TLS gültig (HSTS). Prod (erledigt 20.06. via Prod-Rollout):app./api./admin./captcha./coolify.hivegrid.delösen auf, alle mit gültigem TLS (app/api/captchaCF-proxied,admin/coolifyTraefik+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→ A46.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.delösen alle auf und antworten mit gültigem TLS; Staging-Hostsstaging-app/staging-api/staging-admin→ A46.225.5.93, healthy. - ENV-Anbindung (Meili/mCaptcha/ClamAV): per Umsetzungs-Notiz 19.06. belegt;
captcha.hivegrid.delive 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.dehat bis heute keinen DNS-Record,staging-portal.hivegrid.deliefert 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=falsein 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 Diensteproject_infra_stack(Memory) → Meilisearch/mCaptcha/ClamAV zentral vorhanden, Cloudflaredocs/INTEGRATION-CONTRACTS.md(URL-Schemata / Subdomains aus R-P1a)- abhängig:
AK-INFRA1