118 lines
2.2 KiB
Markdown
118 lines
2.2 KiB
Markdown
# Administrator-Handbuch – [PROJEKT_NAME]
|
||
|
||
> Zielgruppe: **Administratoren** – Menschen, die das System betreiben, deployen und konfigurieren.
|
||
> Voraussetzung: Grundkenntnisse in Linux, Docker und dem eingesetzten Stack.
|
||
|
||
---
|
||
|
||
## Systemvoraussetzungen
|
||
|
||
<!-- TODO: Anforderungen an Host/Server -->
|
||
|
||
| Komponente | Mindestanforderung | Empfohlen |
|
||
|---|---|---|
|
||
| OS | … | … |
|
||
| RAM | … | … |
|
||
| Disk | … | … |
|
||
| Dependencies | … | … |
|
||
|
||
---
|
||
|
||
## Deployment
|
||
|
||
Für Repos mit einem Namen beginnend mit `rd13_` gilt als Standard-Topologie:
|
||
|
||
- Der Runner muss in Docker laufen.
|
||
- Alle Services werden über Caddy als Reverse Proxy ausgeliefert.
|
||
- Die Proxy-Schicht wird zentral im Repo `rd13_system_proxy` gepflegt.
|
||
|
||
### Erstes Aufsetzen
|
||
|
||
<!-- TODO: Schritt-für-Schritt Deployment -->
|
||
|
||
```bash
|
||
# Beispiel
|
||
git clone <repo> /opt/service
|
||
cd /opt/service
|
||
cp .env.example .env
|
||
# .env ausfüllen!
|
||
docker compose up -d
|
||
```
|
||
|
||
### Updates einspielen
|
||
|
||
<!-- TODO: Update-Prozedur -->
|
||
|
||
```bash
|
||
git pull
|
||
docker compose pull
|
||
docker compose up -d --force-recreate
|
||
```
|
||
|
||
---
|
||
|
||
## Konfiguration
|
||
|
||
### Umgebungsvariablen (`.env`)
|
||
|
||
<!-- TODO: Alle relevanten Env-Vars dokumentieren -->
|
||
|
||
| Variable | Pflicht | Default | Beschreibung |
|
||
|---|---|---|---|
|
||
| `EXAMPLE_VAR` | ✓ | – | Beschreibung |
|
||
|
||
### Persistente Daten (`/data/`)
|
||
|
||
Alle persistenten Daten liegen unter `/data/<service>/` im Repo-Root:
|
||
|
||
<!-- TODO: Alle Service-Unterordner und was drin liegt -->
|
||
|
||
| Pfad | Inhalt | Backup-Priorität |
|
||
|---|---|---|
|
||
| `data/<service>/` | … | hoch/mittel/niedrig |
|
||
|
||
**Backup-Hinweise:**
|
||
- `/data/` komplett sichern vor jedem Update
|
||
- Empfehlung: tägliches Backup via Cron / Restic / rsync
|
||
|
||
---
|
||
|
||
## Monitoring & Logs
|
||
|
||
<!-- TODO: Wie überwacht man das System? Wo sind die Logs? -->
|
||
|
||
```bash
|
||
# Logs ansehen
|
||
docker compose logs -f <service>
|
||
|
||
# Status prüfen
|
||
docker compose ps
|
||
```
|
||
|
||
---
|
||
|
||
## Sicherheit
|
||
|
||
<!-- TODO: Firewall-Regeln, Portfreigaben, TLS-Setup etc. -->
|
||
|
||
- Offene Ports: …
|
||
- TLS: …
|
||
- Zugriffskontrolle: …
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
| Symptom | Ursache | Lösung |
|
||
|---|---|---|
|
||
| … | … | … |
|
||
|
||
---
|
||
|
||
## Disaster Recovery
|
||
|
||
<!-- TODO: Was tun wenn es brennt? -->
|
||
|
||
1. Dienst stoppen: `docker compose down`
|
||
2. Backup einspielen: …
|
||
3. Dienst neu starten: `docker compose up -d`
|