Betriebshandbuch an implementierte Dienste angepasst (#12)
- Wiederherstellung: gpg mit Backup-Passwort (age nur für Alt-Sicherungen), DEFINER-Bereinigung wie im Restore-Test, Anhänge zurückspielen und gegen das Manifest prüfen, Migrationen, Prüfliste nach dem Start. - Neuer Abschnitt Dienste/Health/Wiederanlauf (Ports, Startreihenfolge, Restart-Policies, Health-Endpunkte, Herzschlag, Logs, Timer/Path-Units). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
b397c3e3bf
commit
7f6c60ba95
1 changed files with 29 additions and 8 deletions
|
|
@ -61,17 +61,38 @@ systemctl start kc-backup && journalctl -u kc-backup -n 30 --no-pager -o cat
|
|||
Ein ausgefallenes Ziel lässt den Lauf als Fehler zählen (Meldung), das lokale Backup bleibt erhalten.
|
||||
|
||||
## Wiederherstellung (Notfall)
|
||||
1. Neuer/repariertes Server mit MariaDB, Node und `age`; Kundencenter-Code nach `/srv/kundencenter` (Repo), `pnpm install && pnpm build`.
|
||||
2. Sicherungsdatei holen (lokal, Ziel) und den **privaten Schlüssel** bereitlegen.
|
||||
Voraussetzung: das **Backup-Passwort** (Einstellungen → Backup) bzw. bei Alt-Sicherungen der private age-Schlüssel – getrennt vom Server und vom Ziel verwahrt (#65).
|
||||
|
||||
1. Neuer/reparierter Server mit MariaDB, Node 24, pnpm, `gpg` (und `age` für Alt-Sicherungen); Code nach `/srv/kundencenter`, `pnpm install --frozen-lockfile && pnpm build` (als Benutzer `kundencenter`), systemd-Units aus `ops/systemd/` installieren.
|
||||
2. Sicherungsdatei vom Ziel holen (z. B. KeyDisc), Dateiname `kundencenter-DATUM-….tar.gz.gpg` (Alt: `….tar.gz.age`).
|
||||
3. Entschlüsseln und entpacken:
|
||||
```bash
|
||||
age -d -i backup-age-key.txt -o archive.tar.gz kundencenter-DATUM-....tar.gz.age
|
||||
mkdir restore && tar -xzf archive.tar.gz -C restore # enthält db.sql, config/*.env, manifest.json
|
||||
gpg --decrypt -o archive.tar.gz kundencenter-DATUM-….tar.gz.gpg # fragt das Backup-Passwort
|
||||
# Alt-Sicherung: age -d -i backup-age-key.txt -o archive.tar.gz kundencenter-DATUM-….tar.gz.age
|
||||
mkdir restore && tar -xzf archive.tar.gz -C restore # db.sql, config/*.env, manifest.json, ticket-attachments/
|
||||
```
|
||||
4. Konfiguration zurück: `cp restore/config/*.env /etc/kundencenter/` (chmod 600), Datenbank und Benutzer anlegen (nur Rechte auf `kundencenter`).
|
||||
5. Datenbank einspielen: `mysql -u… -p kundencenter < restore/db.sql`
|
||||
6. Dienste starten (`kc-api`, `kc-worker`, `kc-web`), prüfen: `/v1/ready`, Anmeldung, Übersicht, **Audit-Protokoll → „Integrität prüfen“**.
|
||||
7. Erwartung: Datenverlust höchstens bis zum letzten Backup (bis zu 24 h), Wiederherstellung ca. 30 Minuten.
|
||||
4. Konfiguration zurück: `cp restore/config/*.env /etc/kundencenter/` (root, chmod 600). `KC_SECRET_KEY` muss der gesicherte sein, sonst sind 2FA-Geheimnisse und Zugangsdaten unlesbar.
|
||||
5. Datenbank anlegen (`utf8mb4_unicode_ci`) und einspielen. Trigger der Audit-Tabelle tragen einen DEFINER – bei einem anderen DB-Benutzer vorher entfernen (gleiche Regel wie der automatische Restore-Test):
|
||||
```bash
|
||||
sed -E 's#/\*!50017 DEFINER=`[^`]*`@`[^`]*`\*/ ?##g; s# DEFINER=`[^`]*`@`[^`]*`##g' restore/db.sql | mysql -u <benutzer> -p <datenbank>
|
||||
```
|
||||
6. Anhänge zurück: `cp -a restore/ticket-attachments /var/lib/kundencenter/` (Eigentümer `kundencenter`). Anzahl/Größe mit `manifest.json → attachments` vergleichen.
|
||||
7. `pnpm migrate` (wendet nur Neueres an), Dienste starten, prüfen: `/v1/ready`, Anmeldung, Übersicht (Betriebsalarme leer, Worker-Herzschlag frisch), **Audit-Protokoll → „Integrität prüfen“**, ein Ticket-Anhang öffnen.
|
||||
8. Erwartung: Datenverlust höchstens bis zum letzten Backup (bis zu 24 h), Wiederherstellung ca. 30–60 Minuten.
|
||||
|
||||
Der wöchentliche automatische Wiederherstellungstest prüft die Schritte 3, 5 und 6 in der Wegwerf-Datenbank `kundencenter_restoretest` (Prüfsummen, Zeilenzahlen, Migrationen, Audit-Kette, Anhänge laut Manifest, Lesbarkeit der Geheimnisse).
|
||||
|
||||
## Dienste, Health und Wiederanlauf
|
||||
|
||||
| Dienst | Start nach | Health | Neustart | Logs |
|
||||
|---|---|---|---|---|
|
||||
| `kc-api` (:4100) | network-online, mariadb | `GET /v1/health` (lebt), `/v1/ready` (DB) | `Restart=always`, 3 s | `journalctl -u kc-api` |
|
||||
| `kc-worker` | network-online, mariadb, kc-api | `127.0.0.1:4102/health` (Schleife), `/ready` (+DB); Herzschlag in `system_heartbeats` | `Restart=always`, 3 s | `journalctl -u kc-worker` |
|
||||
| `kc-web` (:4101) | network-online, kc-api | HTTP 200 auf `/login` | `Restart=always`, 3 s | `journalctl -u kc-web` |
|
||||
| `kc-backup.timer` / `kc-restore-test.timer` | – | `backup-status.json`, Dashboard | Persistent (holt nach) | `journalctl -u kc-backup` |
|
||||
| `kc-backup-request.path` | – | Anfragen aus der Oberfläche | – | `journalctl -u kc-backup-request` |
|
||||
|
||||
Nach einem Host-Neustart starten alle Dienste automatisch (enabled). Reihenfolge: MariaDB → API → Worker/Web. Ist die DB beim Start noch nicht bereit, beendet sich der Prozess und systemd startet ihn nach 3 s neu. Ausfälle melden die Betriebsalarme (Abschnitt unten); ein ausgefallener Worker wird von der API per Mail gemeldet.
|
||||
|
||||
## Vor größeren Änderungen
|
||||
Vor Migrationen oder Updates manuell sichern: `systemctl start kc-backup`. Rollback einer fehlerhaften Migration = Wiederherstellung (Abschnitt oben) in eine Wegwerf-Datenbank prüfen, dann produktiv einspielen.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue