Files
homelab/docs/ARCHITECTURE_RULES.md

34 lines
921 B
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# KalliLab CORE Architecture Rules
## Grundprinzipien
- Das Git-Repository ist die zentrale Quelle für alle Konfigurationen
- Änderungen werden zuerst im Repo vorgenommen und danach deployed
- Jeder Service hat einen eigenen Stack
## Netzwerk
- Öffentlich erreichbare Services laufen im `frontend_net`
- Interne Services laufen im `backend_net`
- Keine unnötigen Portfreigaben auf dem Host
## Ports
- 80/443 sind ausschließlich für Traefik reserviert
- Jeder Service bekommt einen eigenen, festen Port
- Keine Doppelbelegung von Ports
## Struktur
- Jeder Service hat einen eigenen Ordner unter `/stacks`
- Compose-Dateien liegen immer im jeweiligen Service-Ordner
- Keine gemischten oder globalen Compose-Files
## Sicherheit
- Secrets gehören nicht ins Repository
- Zugangsdaten werden über `.env` oder externe Files geregelt
## Ziel
Ein stabiles, nachvollziehbares und skalierbares Homelab-System