docs(workflows):

This commit is contained in:
2026-03-10 23:00:38 +01:00
parent 3699ec494d
commit 22a3c3145f
2 changed files with 50 additions and 7 deletions

View File

@@ -14,7 +14,6 @@ Ziel:
**Konfiguration passiert lokal in VS Code.**
Die VM ist nur noch Laufzeitumgebung.
1. Lokal ändern, egal was
2. Committen & Pushen
3. der Pull auf der VM wird automatisch über einen Webhook ausgeführt
@@ -28,22 +27,66 @@ flowchart LR
Workspace -->|Markdown changes| MkDocs
MkDocs -->|serve| Browser
```
---
## Verzeichnisstruktur
```
/srv/docker
├─ compose/ # Docker-Compose Stacks für jeden Container
│ ├─ nextcloud/
│ │ └─ docker-compose.yml
│ ├─ tvheadend/
│ │ └─ docker-compose.yml
│ ├─ signal-rest-api/
│ │ └─ docker-compose.yml
│ └─ ... (weitere aktive Container)
├─ scripts/ # Deploy-Scripts, Webhooks, Utilities
│ ├─ deploy-changed-containers-final.sh
│ ├─ webhook-deploy.sh
│ └─ ... (weitere Scripts)
├─ docs/ # MkDocs / Markdown Dokumentation
│ ├─ backup_restore
│ | ├─ docker
| | └─ docker_backup.md
| | ├─ hetzner
│ ├─ docker
│ | ├─ adguardhome
| | | └─ adguardhome.md
│ | ├─ heimdall
| | └─ heimdall.md
| | └─ ... (weitere .md Dateien)
├─ mkdocs.yml # MkDocs Konfiguration
├─ daten/ # Docker-Volumes / persistent data
│ ├─ nextcloud/
│ │ ├─ www/ # Nextcloud Webdaten
│ │ ├─ db/ # MariaDB Daten
│ │ └─ redis/ # Redis Daten
│ ├─ tvheadend/
│ │ └─ config/ # TVHeadend config / recordings
│ ├─ signal-rest-api/
│ │ └─ data/
│ └─ ... (weitere Container-Daten)
└─ .gitignore # ignoriert daten/ und ggf. temp files
```
## 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
- `compose/<Containername>` anlegen
- `compose/<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
- `docker/docs/<Containername>` anlegen
- `Bruchtal/docs/<Containername>/<Containername>.md` anlegen
- `<Containername>.md` editieren, Blaupause z.B: wikijs.md
- commit message `docs(<Containername>): Dokumentation angelegt`