docs: update README - Komodo als primärer Stack-Manager, Traefik 100% Docker-Labels, DNS AdGuard

This commit is contained in:
2026-03-28 15:59:49 +00:00
parent 8ed8081c1c
commit d46ab8d631
+18 -16
View File
@@ -6,21 +6,21 @@ Dieses Repository ist die zentrale Quelle ("Single Source of Truth") für die ko
Vor jeder Änderung lesen: Vor jeder Änderung lesen:
1. 👉 HOMELAB_ARCHITECTURE_MASTER_V2.md 1. 👉 HOMELAB_ARCHITECTURE_MASTER_V2.md
2. 👉 docs/WORKFLOW.md 2. 👉 docs/WORKFLOW.md
## Architektur ## Architektur
- Host: Unraid - Host: Unraid
- Container: Docker (Compose) - Container: Docker (Compose)
- Reverse Proxy: Traefik v3 - Reverse Proxy: Traefik v3 (100% Docker-Labels, kein File-Provider mehr)
- Zugriff: Tailscale (VPN) - Zugriff: Tailscale (VPN)
- DNS: Pi-hole + Unbound - DNS: AdGuard Home + Unbound
- GitOps: Gitea + Portainer (Stacks aus Git) - GitOps: Gitea + Komodo (Stack-Manager)
## Grundprinzipien ## Grundprinzipien
- Alle Änderungen erfolgen über Git (kein manuelles Editieren in Portainer) - Alle Änderungen erfolgen über Git (Komodo deployed automatisch aus Gitea)
- Keine produktiven Container außerhalb von Compose - Keine produktiven Container außerhalb von Compose
- Traefik ist der einzige öffentliche Einstiegspunkt - Traefik ist der einzige öffentliche Einstiegspunkt
- Admin-Dienste sind nicht öffentlich erreichbar (nur via VPN oder Auth) - Admin-Dienste sind nicht öffentlich erreichbar (nur via VPN oder Auth)
@@ -28,24 +28,26 @@ Vor jeder Änderung lesen:
## Repository-Struktur ## Repository-Struktur
- `core/` → Basisdienste - `core/` → Basisdienste (Gitea)
- `security/` → sicherheitskritische Dienste - `security/` → sicherheitskritische Dienste (Vaultwarden)
- `infra/` → Datenbanken & technische Services - `infra/` → Datenbanken & technische Services (PostgreSQL, Redis, DDNS-Updater)
- `apps/` → Anwendungen - `apps/` → Anwendungen (Immich, Paperless, Mealie, Homepage, ...)
- `ops/` → Monitoring & Tools - `ops/` → Monitoring & Tools (Komodo, Scrutiny, Uptime-Kuma, Backrest, ...)
- `host-services/` → Dienste mit Host-Netz - `host-services/` → Dienste mit Host-Netz (AdGuard, Beszel, Tailscale, ...)
- `traefik/` → Reverse Proxy Konfiguration - `traefik/` → Reverse Proxy Konfiguration
- `docs/` → Dokumentation & Prozesse - `docs/` → Dokumentation & Prozesse
- `env/` → Beispiel-Umgebungsvariablen - `env/` → Beispiel-Umgebungsvariablen
## Workflow ## Workflow
1. Änderung im Repository 1. Änderung im Repository (Git)
2. Commit & Push 2. Commit & Push nach Gitea
3. Portainer deployed automatisch 3. Komodo deployed automatisch (GitOps)
4. Testen 4. Testen
5. Dokumentation aktualisieren 5. Dokumentation aktualisieren
## Status ## Status
Initialer Aufbau der Infrastruktur (GitOps Migration gestartet) GitOps-Migration (Sprint 14) abgeschlossen. Komodo ist primärer Stack-Manager.
> ⚠️ Portainer CE läuft noch als Legacy-UI wird in Sprint 5 abgeschaltet.