Files
management/docs/issues/0018-doc-01-wiki-rollout-abschliessen-ci-freigaben.md
Thore CimbalandClaude Opus 4.8 0e34ec9deb docs(issues): reject #0018 as moot, close #0028 as already running
#0018 builds entirely on the Docusaurus aggregate that ADR-0014 replaced, and
sorb confirms wiki.lab is gone — measured, it resolves but answers nothing, so
the Dokploy stack it asks for was never deployed. Its one live part was step 6:
gitops still claimed the docs were served there, corrected in gitops 82412cf.

#0028 turned out to be built already, on the very path the issue proposed:
stillstandspruefung.py reads remote_mirrors and reports last_error, CI runs it on
schedule, and the git.lab schedule is active daily at 00:42 — so an expired mirror
credential goes red within a day instead of freezing production silently. It also
demonstrably fires: it flagged three repos without an active mirror today.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-15 12:00:00 +00:00

3.1 KiB

type, id, status, created, milestone, priority, area, gitlab_iid, related
type id status created milestone priority area gitlab_iid related
issue 0018 rejected 2026-08-01 M2 low infrastructure 18
docs/adr/0014-wikijs-loest-docusaurus-ab.md

DOC-01: Wiki-Rollout abschließen — CI-Freigaben, Zeitplan, Dokploy-Stack, wiki.lab

Import aus management#18 (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).

Das Wiki-Repo homelab/wiki steht (ADR-0006), der Bau ist lokal verifiziert (46 Seiten, 3,6 MB). Zum Betrieb fehlen noch Schritte, die Rechte oder die Dokploy-Oberfläche brauchen:

  1. Job-Token-Freigaben — in jedem Quell-Repo unter Settings → CI/CD → Job token permissions das Projekt homelab/wiki erlauben: axion1337.chat/axion1337.chat-gitops (fürs Wiki-Repo!), homelab/docs, axion1337.chat/management. Ohne das schlägt sync-sources.sh in der CI fehl.
  2. Erste Pipeline in homelab/wiki laufen lassen (manuell) und prüfen, dass registry.git.lab/homelab/wiki:latest entsteht.
  3. Pipeline-Zeitplan anlegen (Build → Pipeline schedules, Vorschlag: täglich nachts) — das ist der eigentliche Aktualisierungsmechanismus.
  4. Dokploy-Stack aus docker-compose.yml, Domain wiki.lab → Port 80, Zertifikat von der aXionLabs-CA.
  5. Lab-DNS: wiki.lab10.58.73.17.
  6. Danach: Link auf wiki.lab in den README der Quell-Repos gegenprüfen (gitops ist erledigt).

Verifikation: https://wiki.lab zeigt die drei Bereiche; eine Änderung in einer Quelle ist nach dem nächsten geplanten Lauf sichtbar.

Verworfen 2026-08-15 — gegenstandslos

wiki.lab existiert nicht mehr; die Lesefläche ist in den Stack gewandert (Bestätigung sorb). Alle sechs Schritte dieses Issues bauen auf dem Docusaurus-Aggregat auf, das ADR-0014 abgelöst hat: „Wiki.js löst Docusaurus als Plattform-Wiki ab" und „das alte Docusaurus-Prinzip entfällt" — editiert wird jetzt in Wiki.js unter wiki.axion1337.chat, statt Quell-Repos read-only zu aggregieren.

Gemessen 2026-08-15: wiki.lab löst zwar noch auf (10.58.73.17, Lab-DNS), antwortet aber nicht (HTTP 000) — der Dokploy-Stack aus Schritt 4 wurde nie deployt. Das Issue beschreibt also einen Aufbau, den niemand mehr will und der nie lief.

Erledigter Teil davon: Schritt 6 (Verweise gegenprüfen) war real offen — gitops:AGENTS.md behauptete weiterhin, die Doku werde als Docusaurus-Seite auf wiki.lab ausgeliefert. Korrigiert in gitops 82412cf. Doku, die auf etwas Totes zeigt, ist schlimmer als keine: sie schickt die nächste Session auf die Suche nach einem abgeschalteten Dienst.

⚠️ Nicht entschieden, gehört sorb: homelab/docs ist laut ADR-0014 bewusst nicht Teil der Plattform und hat damit keine Lesefläche mehr. Ob dafür eine gebraucht wird, ist eine Lab-Frage. Ebenso, ob ADR-0006 (Docusaurus als gemeinsame Lesefläche) auf superseded gesetzt werden sollte — ADR-0014 hat nur ADR-0007 abgelöst.