Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,56 @@
# AK-INFRA2 · DNS + Wildcard-TLS + zentrale Dienste anbinden
| | |
|---|---|
| **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-18 · Gate W1 |
| **Status** | geplant |
## 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.)
## 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)
- `EXTERNALS-CHECKLISTE.md` → C1/C2/C5 (DNS/TLS + Zentral-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`