61 lines
2.0 KiB
Markdown
61 lines
2.0 KiB
Markdown
# Homelab Infrastructure (KalliLab CORE)
|
|
|
|
Dieses Repository ist die zentrale Quelle ("Single Source of Truth") fuer die komplette Infrastruktur meines Homelabs.
|
|
|
|
## WICHTIG - Einstieg
|
|
|
|
Vor jeder Aenderung lesen:
|
|
|
|
1. `HOMELAB_ARCHITECTURE_MASTER_V2.md`
|
|
2. `docs/WORKFLOW.md`
|
|
|
|
## Architektur
|
|
|
|
- Host: Unraid
|
|
- Container: Docker Compose
|
|
- Reverse Proxy: Traefik v3 (Service-Routing via Docker-Labels, File-Provider nur fuer zentrale Dynamic-Config)
|
|
- Zugriff: Tailscale (VPN)
|
|
- DNS: AdGuard Home + Unbound
|
|
- GitOps: Gitea + Komodo
|
|
|
|
## Grundprinzipien
|
|
|
|
- Gitea Online ist der operative Sollzustand.
|
|
- Der lokale Clone ist die Arbeitskopie.
|
|
- Komodo deployed automatisch aus Gitea und ist kein Bearbeitungsort.
|
|
- Keine produktiven Container ausserhalb von Compose.
|
|
- Traefik ist der einzige oeffentliche Einstiegspunkt.
|
|
- Secrets werden niemals im Repository gespeichert.
|
|
|
|
## Repository-Struktur
|
|
|
|
- `core/` -> Basisdienste (Gitea)
|
|
- `security/` -> sicherheitskritische Dienste
|
|
- `infra/` -> Datenbanken und technische Services
|
|
- `apps/` -> Anwendungen
|
|
- `ops/` -> Monitoring und Tools
|
|
- `host-services/` -> Dienste mit Host-Netz
|
|
- `traefik/` -> Reverse Proxy Konfiguration
|
|
- `docs/` -> Dokumentation und Prozesse
|
|
- `env/` -> Beispiel-Umgebungsvariablen
|
|
|
|
## Kurz-Workflow
|
|
|
|
1. In GitHub Desktop `Fetch origin`.
|
|
2. Wenn noetig `Pull origin`.
|
|
3. Lokal aendern.
|
|
4. Commit erstellen.
|
|
5. `Push origin`.
|
|
6. Komodo-Webhook und Ergebnis pruefen.
|
|
7. Doku bei Bedarf aktualisieren.
|
|
|
|
## Status
|
|
|
|
- Komodo ist der primaere und einzige produktive Stack-Manager.
|
|
- Komodo bleibt bewusst bei nativer Authentifizierung; zentrale Traefik-Auth wird dort nicht pauschal vorgeschaltet.
|
|
- Portainer CE ist abgeschaltet und kein Teil des aktiven Betriebs mehr.
|
|
- Homepage ist das aktive produktive Frontend / Start-Dashboard.
|
|
- Traefik `dynamic/` bleibt eine dokumentierte manuelle Host-Sync-Ausnahme ausserhalb des normalen Komodo-Deployments.
|
|
- Mutable Image-Tags sind auf die aktuell laufenden Digests eingefroren; echte Versions-Upgrades erfolgen bewusst separat.
|
|
- Der verbindliche Detailablauf steht in `docs/WORKFLOW.md`.
|