From d46ab8d6319e703b188af27e01325cb07eae0976 Mon Sep 17 00:00:00 2001 From: Micha Date: Sat, 28 Mar 2026 15:59:49 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20update=20README=20-=20Komodo=20als=20pr?= =?UTF-8?q?im=C3=A4rer=20Stack-Manager,=20Traefik=20100%=20Docker-Labels,?= =?UTF-8?q?=20DNS=20AdGuard?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index f3039d2..2006116 100644 --- a/README.md +++ b/README.md @@ -6,21 +6,21 @@ Dieses Repository ist die zentrale Quelle ("Single Source of Truth") für die ko Vor jeder Änderung lesen: -1. 👉 HOMELAB_ARCHITECTURE_MASTER_V2.md -2. 👉 docs/WORKFLOW.md +1. 👉 HOMELAB_ARCHITECTURE_MASTER_V2.md +2. 👉 docs/WORKFLOW.md ## Architektur - Host: Unraid - Container: Docker (Compose) -- Reverse Proxy: Traefik v3 +- Reverse Proxy: Traefik v3 (100% Docker-Labels, kein File-Provider mehr) - Zugriff: Tailscale (VPN) -- DNS: Pi-hole + Unbound -- GitOps: Gitea + Portainer (Stacks aus Git) +- DNS: AdGuard Home + Unbound +- GitOps: Gitea + Komodo (Stack-Manager) ## 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 - Traefik ist der einzige öffentliche Einstiegspunkt - Admin-Dienste sind nicht öffentlich erreichbar (nur via VPN oder Auth) @@ -28,24 +28,26 @@ Vor jeder Änderung lesen: ## Repository-Struktur -- `core/` → Basisdienste -- `security/` → sicherheitskritische Dienste -- `infra/` → Datenbanken & technische Services -- `apps/` → Anwendungen -- `ops/` → Monitoring & Tools -- `host-services/` → Dienste mit Host-Netz +- `core/` → Basisdienste (Gitea) +- `security/` → sicherheitskritische Dienste (Vaultwarden) +- `infra/` → Datenbanken & technische Services (PostgreSQL, Redis, DDNS-Updater) +- `apps/` → Anwendungen (Immich, Paperless, Mealie, Homepage, ...) +- `ops/` → Monitoring & Tools (Komodo, Scrutiny, Uptime-Kuma, Backrest, ...) +- `host-services/` → Dienste mit Host-Netz (AdGuard, Beszel, Tailscale, ...) - `traefik/` → Reverse Proxy Konfiguration - `docs/` → Dokumentation & Prozesse - `env/` → Beispiel-Umgebungsvariablen ## Workflow -1. Änderung im Repository -2. Commit & Push -3. Portainer deployed automatisch +1. Änderung im Repository (Git) +2. Commit & Push nach Gitea +3. Komodo deployed automatisch (GitOps) 4. Testen 5. Dokumentation aktualisieren ## Status -Initialer Aufbau der Infrastruktur (GitOps Migration gestartet) \ No newline at end of file +GitOps-Migration (Sprint 1–4) abgeschlossen. Komodo ist primärer Stack-Manager. + +> ⚠️ Portainer CE läuft noch als Legacy-UI – wird in Sprint 5 abgeschaltet.