Simplify Athena stack and recovery
This commit is contained in:
@@ -9,7 +9,7 @@ Fehlersuche sie benötigt.
|
||||
|
||||
- Host: Debian, ohne lokalen Notfallzugriff oder KVM.
|
||||
- Arbeitsbaum und laufender Stack: `/opt/mike-ai/stack`.
|
||||
- Persistente Daten, Modelle und Recovery: `/data`.
|
||||
- Persistente Daten, Modelle und Backups: `/data`.
|
||||
- Lokale Konfiguration und Secrets: `/etc/mike-ai` (niemals in Git).
|
||||
- Benutzerzugriff auf KI-Dienste: über WireGuard, nicht über das Uni-LAN.
|
||||
- OpenAI-kompatible Modell-API: Profile Router auf Port 8081.
|
||||
@@ -23,7 +23,7 @@ Fehlersuche sie benötigt.
|
||||
|---|---|
|
||||
| `/opt/mike-ai/stack` | Einziger Git-Checkout und einzige Quelle für Deployments |
|
||||
| `/data/models` | GGUF-Modelle, Projektoren und weitere große Modelldateien |
|
||||
| `/data` | Persistente Anwendungsdaten und Recovery-Koffer |
|
||||
| `/data` | Persistente Anwendungsdaten und Docker-Backups |
|
||||
| `/etc/mike-ai` | Lokale Env-Dateien, API-Schlüssel und SSH-Schlüssel |
|
||||
| `/tmp` | Einmalige Hilfsprogramme und temporäre Arbeitsdateien |
|
||||
|
||||
@@ -52,7 +52,7 @@ eingebunden werden; das richtet sich nach dem Auftrag.
|
||||
4. Änderung über `athena_operator_change` ausführen.
|
||||
5. Syntax, Compose, Dienstzustand und eine kleine Funktionsprobe prüfen.
|
||||
6. Geänderte Dateien committen und pushen.
|
||||
7. Recovery nur nach abgeschlossenen, funktionierenden Änderungen erneuern.
|
||||
7. Ein manuelles Datenbackup nur nach speicherrelevanten Änderungen auslösen.
|
||||
|
||||
Nicht bei jedem Zwischenschritt die gesamte Plattform neu untersuchen. Keine
|
||||
vollständigen Compose-, Installations- oder Dokumentationsdateien in den Chat
|
||||
@@ -64,9 +64,10 @@ Werkzeugaufruf wird höchstens einmal wiederholt.
|
||||
Für einen neuen MCP sind gewöhnlich nur diese Teile nötig:
|
||||
|
||||
1. Servercode und Dockerfile unter `platform/mcp/`.
|
||||
2. Ein Service in `platform/mcp/compose.yaml`.
|
||||
2. Ein Service im eingebundenen `platform/mcp/compose.yaml`.
|
||||
3. Eine Env-Beispieldatei unter `config/`; echte Werte nach `/etc/mike-ai`.
|
||||
4. Registrierung in Hermes und optional OpenWebUI.
|
||||
4. Genau ein Eintrag in `config/mcp-registry.json`; daraus werden Hermes und
|
||||
OpenWebUI automatisch erzeugt.
|
||||
5. Ein kleiner Test sowie ein kurzer Eintrag in dieser Datei oder in der
|
||||
Komponentenübersicht, falls wirklich zusätzliche Erklärung nötig ist.
|
||||
|
||||
@@ -104,17 +105,13 @@ Eine Änderung ist erst fertig, wenn:
|
||||
- der betroffene Dienst den neuen Stand verwendet,
|
||||
- ein fokussierter Test erfolgreich war,
|
||||
- Git-Status und Commit bekannt sind,
|
||||
- bei einer wesentlichen Änderung der Recovery-Koffer aktualisiert wurde.
|
||||
- das automatische Backup läuft und bei Datenänderungen ein Archiv geprüft wurde.
|
||||
|
||||
Bei Unsicherheit wird der konkrete offene Punkt genannt. Es werden keine
|
||||
Ergebnisse, Werkzeugaufrufe oder erfolgreichen Deployments erfunden.
|
||||
|
||||
## Detailreferenzen
|
||||
|
||||
- Installation und Wiederherstellung: `docs/INSTALLATION.md`,
|
||||
`docs/DISASTER_RECOVERY.md`
|
||||
- Aktuelle Modellprofile: `docs/STANDARD_PROFILE_MATRIX.md`
|
||||
- Netzwerk und externer Standort: `docs/WIREGUARD_HOME_PEER.md`,
|
||||
`docs/VPN_SERVICE_PORTS.md`
|
||||
- Historische Entscheidungen und Benchmarks: übrige Dateien unter `docs/`
|
||||
## Referenzen
|
||||
|
||||
- Installation und Überblick: `README.md`
|
||||
- Wiederherstellung: `docs/RECOVERY.md`
|
||||
- Modellprofile: `docs/STANDARD_PROFILE_MATRIX.md`
|
||||
|
||||
Reference in New Issue
Block a user