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

66 lines
5.5 KiB
Markdown

# 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
- [x] **Meilisearch** (scoped-Key) per ENV angebunden — `MEILI_URL` + `MEILI_API_KEY` auf web/api/worker gesetzt (Coolify, verifiziert 19.06.)
- [x] **mCaptcha** per ENV angebunden — `MCAPTCHA_INSTANCE_URL`/`_ACCOUNT_SECRET`/`_SITEKEY_*` + `CAPTCHA_FAIL_OPEN` gesetzt; live: `captcha.saas-ctrl.com`
- [x] **ClamAV** per ENV angebunden — `CLAMAV_HOST` (10.42.0.4, privates Netz) + `CLAMAV_PORT` gesetzt
- [x] **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`