docs(Workflow): neu erstellt
This commit is contained in:
64
docs/workflows/docker-workflow.md
Normal file
64
docs/workflows/docker-workflow.md
Normal file
@@ -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
|
||||||
@@ -8,10 +8,11 @@ theme:
|
|||||||
|
|
||||||
nav:
|
nav:
|
||||||
- Übersicht: index.md
|
- Übersicht: index.md
|
||||||
|
- Workflows:
|
||||||
|
- docker-workflow: workflows/docker-workflow.md
|
||||||
- Netzwerk:
|
- Netzwerk:
|
||||||
- Topologie: network/topology.md
|
- Topologie: network/topology.md
|
||||||
- Tunnel: network/tunnel.md
|
- Tunnel: network/tunnel.md
|
||||||
|
|
||||||
- Proxmox:
|
- Proxmox:
|
||||||
- VMs: proxmox/vms.md
|
- VMs: proxmox/vms.md
|
||||||
- Docker:
|
- Docker:
|
||||||
|
|||||||
Reference in New Issue
Block a user