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:
co-authored by
Claude Fable 5
parent
ba9783fa08
commit
cdecb006d4
@@ -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;
|
||||||
|
|||||||
@@ -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.
|
||||||
Reference in New Issue
Block a user