Micha
4007da3302
Bulk-Renovate-Merge loest parallele Komodo-Deploys aus; Image-Pulls scheitern mit DNS connection refused, weil AdGuard (einziger Host-Resolver) im selben Batch recreated wird. Runbook haelt Symptom, Ursache, Sofortmassnahme (Unraid DNS2) und Betriebsregel fest. Verweis in REPO_MAP ergaenzt. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
Repository Map
Stand: 2026-05-31
Kurzkarte des Repositories. Diese Datei ist bewusst kein zweites Handbuch; fuer Details gilt immer die betroffene Compose-Datei oder das jeweilige Runbook.
Top-Level
| Pfad | Zweck |
|---|---|
apps/ |
produktive Anwendungen und vorbereitete App-Stacks |
core/ |
Basisdienste, aktuell Gitea |
docs/ |
aktive Betriebsdoku, Restore, Inventare, Arbeitsregeln |
env/ |
nicht geheime Beispiel-Env-Dateien |
host-services/ |
host-nahe Dienste mit direkten Ports oder Host-Netz |
infra/ |
technische Infrastruktur wie PostgreSQL, Redis, DDNS |
monitoring/ |
Prometheus, Grafana, Loki, InfluxDB 3 Core |
ops/ |
Admin-, Backup-, Restore- und Wartungswerkzeuge |
security/ |
Authelia, Vaultwarden und Security-Konfiguration |
services/ |
Host-seitige Betriebsskripte und Recovery-Hilfen |
traefik/ |
Reverse Proxy und dynamic File-Provider-Konfiguration |
Einstiegspunkte
| Datei | Wann lesen |
|---|---|
README.md |
Repo-Einstieg |
HOMELAB_ARCHITECTURE_MASTER_V2.md |
Architektur, Netzmodell, Ausnahmen |
docs/WORKFLOW.md |
vor operativen Aenderungen |
docs/SERVICE_CATALOG.md |
Service-Zweck, Pfade, Besonderheiten |
docs/DISASTER_RECOVERY.md |
echter Wiederanlauf |
docs/RESTORE_MATRIX.md |
Restore-Quelle je Dienst |
docs/SECRETS_MAP.md |
Secret-Namen und Pfade ohne Werte |
docs/GITOPS_DRIFT_RUNBOOK.md |
Git/Gitea/Komodo/Docker/Host-Drift |
docs/AUDIT_2026-05-25_TODO.md |
aktuelle Restliste |
docs/DR_WORKSTATION_SETUP.md |
Schritt-fuer-Schritt-Runbook fuer den DR-Gaming-PC (WSL2 + Borg-Client + SSH-Keys) |
docs/runbooks/komodo-bulk-deploy-dns.md |
Bulk-Deploy-Pulls scheitern an DNS, wenn AdGuard im selben Batch recreated wird |
Wichtige Skripte
| Datei | Zweck |
|---|---|
ops/borg-ui/scripts/pre-backup-dumps.sh |
Dump-Erzeugung vor Borg |
ops/borg-ui/scripts/gitea-bundle-mirror.sh |
Gitea-Bundles fuer DR |
ops/restore-tests/run-restore-checks.sh |
Restore-Test-Einstieg |
ops/restore-tests/schedule.md |
Restore-Test-Kadenz |
services/posture-check/posture-check.sh |
Host-Posture-Check |
services/posture-check/export-prometheus-textfile.sh |
Borg-/Container-/Drift-Metriken |
services/authelia-diff.sh |
Authelia ACL Repo-zu-Host-Vergleich |
ops/h-drive-nearline/pull-critical-backups.ps1 |
H:/ Nearline-Pull |
Arbeitsregel
Neue Doku nur anlegen, wenn sie dauerhaft als Runbook, Inventar oder Restliste gebraucht wird. Einmalige Audits, Prompt-Kopien und lange Verlaufsprotokolle gehoeren in Git-Commits, nicht als neue Markdown-Dateien.