docs/issues/0018-doc-01-wiki-rollout-abschliessen-ci-freigaben.md

---
type: issue
id: "0018"
status: rejected
created: 2026-08-01
milestone: M2
priority: low
area: infrastructure
gitlab_iid: "18"
related: [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](https://git.lab/axion1337.chat/management/-/issues/18) (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).

Das Wiki-Repo [`homelab/wiki`](https://git.lab/homelab/wiki) steht ([ADR-0006](https://git.lab/axion1337.chat/management/-/blob/main/decisions/0006-wikis-konsolidieren-docusaurus.md)), 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.lab` → `10.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.
feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`---`
			`type: issue`
			`id: "0018"`
docs(issues): reject #0018 as moot, close #0028 as already running 2026-08-15 12:00:00 +00:00			`status: rejected`
feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`created: 2026-08-01`
			`milestone: M2`
			`priority: low`
			`area: infrastructure`
			`gitlab_iid: "18"`
docs(issues): reject #0018 as moot, close #0028 as already running 2026-08-15 12:00:00 +00:00			`related: [docs/adr/0014-wikijs-loest-docusaurus-ab.md]`
feat: slice 4 - the open management issues live in the repo 2026-08-11 12:00:00 +00:00			`---`
			`# DOC-01: Wiki-Rollout abschließen — CI-Freigaben, Zeitplan, Dokploy-Stack, wiki.lab`

			`> Import aus [management#18](https://git.lab/axion1337.chat/management/-/issues/18) (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).`

			Das Wiki-Repo [`homelab/wiki`](https://git.lab/homelab/wiki) steht ([ADR-0006](https://git.lab/axion1337.chat/management/-/blob/main/decisions/0006-wikis-konsolidieren-docusaurus.md)), 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.lab` → `10.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.
docs(issues): reject #0018 as moot, close #0028 as already running 2026-08-15 12:00:00 +00:00
			`## 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.`