Doku-Topologie: Wiki liegt auf git.lab, wiki.lab als gemeinsame Leseflaeche

Warnung ergaenzt, dass der wiki-Branch ein ueberholter Mai-Abzug ist und nicht
die gepflegte Fassung (ADR-0006 im management-Repo).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj
This commit is contained in:
Thore Cimbal
2026-08-01 12:00:00 +00:00
co-authored by Claude Fable 5
parent ba9783fa08
commit cdecb006d4
2 changed files with 24 additions and 4 deletions
+9 -1
View File
@@ -39,7 +39,8 @@ Gitea; the mirror delivers). **Never push directly to Gitea** for this repo —
force-overwrites divergent state. The same rule applies to ThreadNet-Web, threadnet-call, force-overwrites divergent state. The same rule applies to ThreadNet-Web, threadnet-call,
thread-net-git, threadnet-operating and (since 2026-08-01) `management` (the former thread-net-git, threadnet-operating and (since 2026-08-01) `management` (the former
`Backlogs` repo, renamed in the PM-framework restructuring — ADRs/vision/roadmap live `Backlogs` repo, renamed in the PM-framework restructuring — ADRs/vision/roadmap live
there); only this repo's **wiki** is still direct-to-Gitea. there). **Since 2026-08-02 the wiki lives on git.lab too** — there is no direct-to-Gitea
exception left.
**Issues live on git.lab** (migrated 2026-08-01, gitops#48): the old Gitea issues are **Issues live on git.lab** (migrated 2026-08-01, gitops#48): the old Gitea issues are
closed with a pointer to their GitLab counterpart. ⚠️ gitops issue numbers **shifted** closed with a pointer to their GitLab counterpart. ⚠️ gitops issue numbers **shifted**
@@ -50,6 +51,13 @@ One exception: **deploy-handover issues** stay on the Gitea `sorb/management` tr
because CFGMON has no route to git.lab (to be retired by the site-to-site VPN, ADR-0004 because CFGMON has no route to git.lab (to be retired by the site-to-site VPN, ADR-0004
in the management repo). in the management repo).
**Wiki** (migrated 2026-08-02): the 15 pages now live in this project's GitLab wiki
(`…-gitops.wiki.git`, *Wiki* tab). ⚠️ The **`wiki` branch in this repo is NOT the wiki** —
it is a stale May snapshot of `docs/`; don't edit or trust it. All doc sources
(platform wiki, `homelab/docs`, `management`) are also served side by side as one
Docusaurus site at **wiki.lab**, configured in `git.lab/homelab/wiki` — content is
pulled at build time, so edits always belong in the source repo.
**Exception that needs manual handling**: the monthly TURN-rotation CronJob runs in the **Exception that needs manual handling**: the monthly TURN-rotation CronJob runs in the
cluster (no route to git.lab) and still opens its PR on Gitea. Never merge that PR on cluster (no route to git.lab) and still opens its PR on Gitea. Never merge that PR on
Gitea — instead fetch the rotation branch, merge it into main locally, push to git.lab; Gitea — instead fetch the rotation branch, merge it into main locally, push to git.lab;
+15 -3
View File
@@ -142,8 +142,20 @@ gebündelt.
Lab auflösbar) — dort wird gepusht und läuft der CI-Verifikations-Job (`.gitlab-ci.yml`). Lab auflösbar) — dort wird gepusht und läuft der CI-Verifikations-Job (`.gitlab-ci.yml`).
Die Kopie auf `rohana.axion1337.de` ist ein automatischer **Push-Mirror** und bleibt die Die Kopie auf `rohana.axion1337.de` ist ein automatischer **Push-Mirror** und bleibt die
**Flux-Quelle**: der Cluster zieht unverändert von Gitea, der Mirror liefert. **Niemals **Flux-Quelle**: der Cluster zieht unverändert von Gitea, der Mirror liefert. **Niemals
direkt nach rohana pushen** — der Mirror überschreibt divergente Stände. Issues, Wiki und direkt nach rohana pushen** — der Mirror überschreibt divergente Stände.
Releases bleiben auf Gitea.
**Issues und Wiki liegen seit 2026-08-01/02 ebenfalls auf git.lab**
([Issues](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/issues) ·
[Wiki](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/wikis/home) — der
Wiki-Reiter oben im Projekt). ⚠️ Die Issue-Nummern haben sich beim Umzug verschoben;
ein alter Verweis „gitops#N" meint die Gitea-Nummer, verbindlich ist der
Migrations-Fußtext im jeweiligen Issue. **Releases bleiben auf Gitea** (öffentlicher
Download-Pfad). Der `wiki`-Branch in diesem Repo ist ein **überholter Abzug von
`docs/` aus dem Mai** und nicht die gepflegte Fassung.
Alle Dokumentationsquellen zusammen (Plattform, Homelab, Arbeitsweise) gibt es unter
**[wiki.lab](https://wiki.lab)** — Konfiguration im Repo
[`homelab/wiki`](https://git.lab/homelab/wiki).
**Abhängigkeits-Logik:** Flux installiert erst `infra-apps` (damit Namespaces und Repositories existieren) und danach `production-apps` (das eigentliche ESS-Chart). **Abhängigkeits-Logik:** Flux installiert erst `infra-apps` (damit Namespaces und Repositories existieren) und danach `production-apps` (das eigentliche ESS-Chart).
@@ -292,5 +304,5 @@ sops apps/production/custom-configs/mas-secret.yaml
* **`CLAUDE.md`** (Repo-Root): Technische Referenz für KI-gestützte Arbeit an diesem Repo - Architektur, bekannte Chart-Quirks, Troubleshooting-Checkliste. * **`CLAUDE.md`** (Repo-Root): Technische Referenz für KI-gestützte Arbeit an diesem Repo - Architektur, bekannte Chart-Quirks, Troubleshooting-Checkliste.
* **`docs/TASKS.md`**: Backlog-Pointer zu den [Gitea Issues](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/issues) - Details werden nicht mehr doppelt gepflegt. * **`docs/TASKS.md`**: Backlog-Pointer zu den [Gitea Issues](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/issues) - Details werden nicht mehr doppelt gepflegt.
* **[Gitea Releases](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/releases)**: Versionshistorie (SemVer, `vMAJOR.MINOR.PATCH` als Änderungsgrößen-Konvention, kein Kompatibilitätsvertrag - siehe [[00-TASKS]] Wiki für die Konvention). * **[Gitea Releases](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/releases)**: Versionshistorie (SemVer, `vMAJOR.MINOR.PATCH` als Änderungsgrößen-Konvention, kein Kompatibilitätsvertrag - siehe [[00-TASKS]] Wiki für die Konvention).
* **[Wiki](https://rohana.axion1337.de/sorb/axion1337.chat-gitops/wiki)**: Ausführliche Historie, Incident-Notizen, Setup-Guides pro Komponente. * **[Wiki](https://git.lab/axion1337.chat/axion1337.chat-gitops/-/wikis/home)** (auf git.lab, Reiter *Wiki*): Ausführliche Historie, Incident-Notizen, Setup-Guides pro Komponente. Zusammen mit Homelab- und Verfahrensdoku auch unter **[wiki.lab](https://wiki.lab)**.
* **`docs/deployment-guides/`**: Detaillierte Guides für TURN-Server, Authentik, Monitoring, Element-Customization, Room-Policies, Moderation & Content-Scanning, Host-Wartungsbenachrichtigungen. * **`docs/deployment-guides/`**: Detaillierte Guides für TURN-Server, Authentik, Monitoring, Element-Customization, Room-Policies, Moderation & Content-Scanning, Host-Wartungsbenachrichtigungen.