Files
management/docs/issues/0048-wikijs-in-der-suite-deployen.md
T
Thore Cimbal c08611a2bd docs(adr): record wiki git-storage architecture (ADR-0015) + build progress
The cluster cannot reach git.lab (deliberate lab-independence), so #0048's
git.lab-repo-as-storage is infeasible. ADR-0015 routes Wiki.js content
cluster→Gitea→canonize to git.lab, reusing the accepted TURN-rotation pattern;
status proposed, pending sorb's ratification and two prerequisites (Gitea repo +
deploy PAT). Note the flagged contradiction on #0048 and the live theming
progress (logo, shared login background, dark default) on #0050. STATUS regen.
2026-08-13 12:00:00 +00:00

2.5 KiB

type, id, status, created, milestone, priority, area, related
type id status created milestone priority area related
issue 0048 open 2026-08-12 M4 medium infrastructure
docs/adr/0014-wikijs-loest-docusaurus-ab.md
docs/issues/0046-wiki-in-threadnet-server-suite-umziehen.md

Wiki.js in der ThreadNet Server Suite deployen (k8s + Postgres + Git-Storage)

Problem / Motivation

ADR-0014: Wiki.js löst Docusaurus ab und wird Teil der ThreadNet Server Suite (k8s), nicht mehr ein Overmind-Einzelstack. Braucht das Deployment plus den Inhalts-Speicher.

Acceptance

  • Wiki.js läuft in der Suite (k8s): Deployment, Postgres (Rendern/Auth/Suche), in die GitOps-Definition aufgenommen (Flux).
  • Öffentlich erreichbar unter wiki.axion1337.chat (Entscheidung sorb 2026-08-12) — wie die übrigen Subdomains: A-Record → 49.13.132.245, cert-manager Certificate via ClusterIssuer letsencrypt-prod (Secret wiki-axion1337-chat-tls), Traefik-IngressRoute Host(wiki.axion1337.chat) → Service wikijs:3000. Muster: apps/authentik/ingress.yaml. Kein Forward-Auth/Outpost — Wiki.js loggt selbst via OIDC ein (#0049).
  • Neues wiki-Repo auf git.lab angelegt (gespiegelt wie die übrigen), als Wiki.js Git-Storage eingebunden (bidirektionaler Sync) — Inhalt liegt in git (hartes Kriterium, ADR-0014).
  • Grundstruktur für Betrieb und Anwender angelegt (zwei Bereiche); homelab/docs ausdrücklich nicht eingebunden.
  • Postgres ist gesichert (Backup), da git nur Inhalt, nicht den Laufzeit-Zustand hält.

Notes

Ersetzt den Forward-Auth-Zwischenstand auf Overmind (Guide 09, #0024). OIDC + Rollen kommen in #0049, Theming in #0050. Umbrella: #0046.

Update 2026-08-13 — Git-Storage-Architektur korrigiert (Widerspruch)

Deployment, Postgres, Ingress/Cert, öffentliche Erreichbarkeit, OIDC/Rollen (#0049) und Theming (#0050) laufen live und reproduzierbar über den Konfig-Job.

Offen ist nur der Git-Storage — und die oben geforderte Fassung ist so nicht machbar: „wiki-Repo auf git.lab, gespiegelt wie die übrigen, als Storage" setzt voraus, dass Wiki.js git.lab erreicht. Tut es nicht — der Cluster erreicht bewusst nur Gitea (verifiziert 2026-08-13). Auflösung in ADR-0015: Wiki.js→Gitea (sorb/wiki), CI kanonisiert Gitea→git.lab (Muster canonize_rotation).

Voraussetzung (nur sorb): Gitea-Repo sorb/wiki (privat) anlegen + dedizierten Deploy-PAT bereitstellen. Danach verdrahtet der Agent Storage + Kanonisierungs-Job.