Bruchtal/docs/workflows/docker-workflow.md

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/ anlegen
• Bruchtal//docker-compose.yml anlegen
• docker-compose.yml editieren,
• commit mit Message "infra(): docker-compose.yml neu angelegt"
• push

neuen Container dokumentieren

• Bruchtal/docs/ anlegen
• Bruchtal/docs//.md anlegen
• .md editieren, Blaupause z.B: wikijs.md
• commit message docs(): Dokumentation angelegt
• Bruchtal/mkdocs.md: nav sinnvoll ergänzen
• commit message docs(mkdocs): ergänzt
• push

Übernehmen auf VM Docker

ssh docker
cd /docker/Bruchtal
git pull
cd /docker/Bruchtal/<Containername>
docker compose up -d

Repository-Struktur

Bruchtal/ ├── docker/ │ └── / │ └── docker-compose.yml └── docs/ └── docker/ └── / └── .md