docs(Workflow): neu erstellt

docs/workflows/docker-workflow.md

@@ -0,0 +1,64 @@
+# Docker-Workflow (Bruchtal Standard)
+
+Dieser Workflow ist verbindlich für alle Änderungen an Docker-Stacks in Bruchtal.
+
+Ziel:
+- Keine Konfiguration direkt auf der VM
+- Alles versioniert in Git
+- Reproduzierbare Deployments
+- Dokumentation immer synchron zur Infrastruktur
+
+---
+
+## Grundprinzip
+
+**Konfiguration passiert lokal in VS Code.**
+Die VM ist nur noch Laufzeitumgebung.
+
+
+1. Lokal ändern, egal 
+2. Committen & Pushen
+3. Auf VM pullen
+4. Container neu starten
+
+---
+
+## Workflow "neuer Container"
+- VSCode starten in ~Bruchtal mit code . => VS startet sauber mit der Giteinstellung
+**ALLE ÄNDERUNGEN NUR IN VS**
+
+### neuen Containeranlegen
+- Bruchtal/<Containername> anlegen
+- Bruchtal/<Containername>/docker-compose.yml anlegen
+- docker-compose.yml editieren, 
+- commit mit Message "infra(<Containername>): docker-compose.yml neu angelegt"
+- push
+
+
+### neuen Container dokumentieren
+- Bruchtal/docs/<Containername> anlegen
+- Bruchtal/docs/<Containername>/<Containername>.md anlegen
+- <Containername>.md editieren, Blaupause z.B: wikijs.md
+- commit message docs(<Containername>): Dokumentation angelegt
+- Bruchtal/mkdocs.md: nav sinnvoll ergänzen
+- commit message docs(mkdocs): <Containername> ergänzt
+- push
+
+### Übernehmen auf VM Docker
+```bash
+ssh docker
+cd /docker/Bruchtal
+git pull
+cd /docker/Bruchtal/<Containername>
+docker compose up -d
+```
+
+## Repository-Struktur
+Bruchtal/
+├── docker/
+│ └── <Containername>/
+│       └── docker-compose.yml
+└── docs/
+    └── docker/
+        └── <stack>/
+            └── <stack>.md

mkdocs.yml

@@ -8,10 +8,11 @@ theme:
 
 nav:
   - Übersicht: index.md
+  - Workflows:
+      - docker-workflow: workflows/docker-workflow.md
   - Netzwerk:
       - Topologie: network/topology.md
       - Tunnel: network/tunnel.md
-
   - Proxmox:
       - VMs: proxmox/vms.md
   - Docker:
@@ -20,4 +21,4 @@ nav:
       - Architektur: docker/architecture.md
   - Backup_Storage:
         - Backup: backup/backup.md
-        - Storage: backup/storage.md
+        - Storage: backup/storage.md