Compare commits

...
2 Commits
Author SHA1 Message Date
LarsandClaude Opus 5.5 347ca50e71 Container: Vault-Prüfung ohne festen Dateiaufbau (wie systemd)
Deploy mindnet DEV (Container) / deploy (push) Successful in 50s
Der Preflight verlangte _system/dictionary/edge_vocabulary.md, die es nur
im NAS-Vault gibt. Der Dev-Vault vault_master ist anders aufgebaut, systemd
prüft nichts davon. Jetzt: Vault muss lesbar und nicht leer sein; eine
bestimmte Datei nur noch optional über MINDNET_VAULT_SENTINEL. Default für
MINDNET_VAULT_ROOT wie in app/config.py.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 21:47:24 +01:00
LarsandClaude Opus 5.5 6a2ab522fc Docs: Gitea-Runner läuft als llmadmin, nicht als root
Deploy mindnet DEV (Container) / deploy (push) Failing after 30s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 21:43:19 +01:00
4 changed files with 45 additions and 17 deletions

No files matched your search

+16 -4
View File
@@ -102,14 +102,26 @@ def _is_read_only_mount(path: Path) -> bool:
return bool(os.statvfs(path).f_flag & os.ST_RDONLY) return bool(os.statvfs(path).f_flag & os.ST_RDONLY)
DEFAULT_VAULT_ROOT = "./vault_master" # Default aus app/config.py
def check_vault() -> None: def check_vault() -> None:
if not _flag("MINDNET_VAULT_REQUIRED", "true"): if not _flag("MINDNET_VAULT_REQUIRED", "true"):
return return
root = Path(os.getenv("MINDNET_VAULT_ROOT", "")) root = Path(os.getenv("MINDNET_VAULT_ROOT") or DEFAULT_VAULT_ROOT)
if not str(root) or not root.is_dir(): if not root.is_dir():
raise PreflightError(f"Vault-Verzeichnis fehlt: '{root}'.") raise PreflightError(f"Vault-Verzeichnis fehlt: '{root}'.")
# Ein ausgefallenes NAS hinterlässt einen leeren Mountpunkt; der Sentinel unterscheidet das. # Ein ausgefallenes NAS hinterlässt einen leeren Mountpunkt.
sentinel = root / os.getenv("MINDNET_VAULT_SENTINEL", "_system/dictionary/edge_vocabulary.md") try:
empty = next(root.iterdir(), None) is None
except OSError:
raise PreflightError(f"Vault '{root}' nicht lesbar (NAS nicht gemountet?).") from None
if empty:
raise PreflightError(f"Vault '{root}' ist leer (NAS nicht gemountet?).")
# Optional: zusätzlich eine bestimmte Datei verlangen (z. B. auf dem NAS-Vault).
sentinel_name = os.getenv("MINDNET_VAULT_SENTINEL", "").strip()
if sentinel_name:
sentinel = root / sentinel_name
try: try:
with sentinel.open("rb") as f: with sentinel.open("rb") as f:
f.read(1) f.read(1)
+8 -4
View File
@@ -28,10 +28,14 @@ def main(mode: str) -> int:
print(f"health: {mode} nicht erreichbar ({type(e).__name__})") print(f"health: {mode} nicht erreichbar ({type(e).__name__})")
return 1 return 1
if mode == "api" and os.getenv("MINDNET_VAULT_REQUIRED", "true").lower() == "true": if mode == "api" and os.getenv("MINDNET_VAULT_REQUIRED", "true").lower() == "true":
root = Path(os.getenv("MINDNET_VAULT_ROOT", "")) root = Path(os.getenv("MINDNET_VAULT_ROOT") or "./vault_master")
sentinel = root / os.getenv("MINDNET_VAULT_SENTINEL", "_system/dictionary/edge_vocabulary.md") sentinel_name = os.getenv("MINDNET_VAULT_SENTINEL", "").strip()
if not sentinel.is_file(): try:
print(f"health: Vault-Sentinel fehlt ({sentinel})") ok = (root / sentinel_name).is_file() if sentinel_name else next(root.iterdir(), None) is not None
except OSError:
ok = False
if not ok:
print(f"health: Vault leer oder nicht lesbar ({root})")
return 1 return 1
return 0 return 0
+3 -3
View File
@@ -75,7 +75,7 @@ Der aktuelle Lock wurde mit `--exclude-newer 2026-01-22` erzeugt, also dem Stand
| `MINDNET_ENV` ∈ {dev, prod}; `COLLECTION_PREFIX` explizit; Dev nur `*_dev`, Prod nie `*_dev` | Dev schreibt in Prod-Collections; stiller Default `mindnet` | | `MINDNET_ENV` ∈ {dev, prod}; `COLLECTION_PREFIX` explizit; Dev nur `*_dev`, Prod nie `*_dev` | Dev schreibt in Prod-Collections; stiller Default `mindnet` |
| `VECTOR_DIM == 768`, Profil `embedding_expert` = ollama/`nomic-embed-text`/768, kein abweichendes `MINDNET_EMBEDDING_MODEL` | stiller Rückfall auf 384 (MiniLM) in `qdrant.py` bzw. auf das Chat-Modell als Embedding | | `VECTOR_DIM == 768`, Profil `embedding_expert` = ollama/`nomic-embed-text`/768, kein abweichendes `MINDNET_EMBEDDING_MODEL` | stiller Rückfall auf 384 (MiniLM) in `qdrant.py` bzw. auf das Chat-Modell als Embedding |
| Cloud-Key gesetzt ohne `MINDNET_ALLOW_CLOUD_EGRESS=true` | unmaskierte Vault-Inhalte an OpenRouter/Gemini | | Cloud-Key gesetzt ohne `MINDNET_ALLOW_CLOUD_EGRESS=true` | unmaskierte Vault-Inhalte an OpenRouter/Gemini |
| Vault fehlt, Sentinel nicht lesbar, Mount nicht `ro` (`statvfs` `ST_RDONLY`) | Arbeiten auf leerem NAS-Mountpunkt; Schreiben in den Vault (R2) | | Vault fehlt, leer oder nicht lesbar, optionaler Sentinel fehlt, Mount nicht `ro` (`statvfs` `ST_RDONLY`) | Arbeiten auf leerem NAS-Mountpunkt; Schreiben in den Vault (R2) |
| `MINDNET_OLLAMA_URL`/`QDRANT_URL` fehlen oder zeigen auf `localhost`/`127.0.0.1` | App fiele still auf `127.0.0.1` zurück, im Container also auf sich selbst | | `MINDNET_OLLAMA_URL`/`QDRANT_URL` fehlen oder zeigen auf `localhost`/`127.0.0.1` | App fiele still auf `127.0.0.1` zurück, im Container also auf sich selbst |
Umgebung, Dimension, Schreibschutz und die Adressen der Host-Dienste stehen in den Compose-Dateien unter `environment` und haben Vorrang vor beiden env-Dateien. Präfix und Vault-Pfad kommen aus der `.env` der systemd-Instanz. Die Präfix-Regel gilt trotzdem: Dev nur `*_dev`, Prod nie. Umgebung, Dimension, Schreibschutz und die Adressen der Host-Dienste stehen in den Compose-Dateien unter `environment` und haben Vorrang vor beiden env-Dateien. Präfix und Vault-Pfad kommen aus der `.env` der systemd-Instanz. Die Präfix-Regel gilt trotzdem: Dev nur `*_dev`, Prod nie.
@@ -100,7 +100,7 @@ docker compose -f deploy/compose.dev.yml --env-file "$MINDNET_ENV_FILE" run --rm
- **Gleicher Vault wie systemd:** `deploy/appenv.py` liest `MINDNET_VAULT_ROOT` aus der `.env`. Ein relativer Pfad wird wie bei systemd gegen das `WorkingDirectory` (Ordner der `.env`) aufgelöst und im Container unter `/app/<pfad>` eingehängt, ein absoluter Pfad 1:1. Dadurch zeigt derselbe Wert im Container auf dasselbe Verzeichnis. Fehlt der Wert, gilt der App-Default `./vault_master`. - **Gleicher Vault wie systemd:** `deploy/appenv.py` liest `MINDNET_VAULT_ROOT` aus der `.env`. Ein relativer Pfad wird wie bei systemd gegen das `WorkingDirectory` (Ordner der `.env`) aufgelöst und im Container unter `/app/<pfad>` eingehängt, ein absoluter Pfad 1:1. Dadurch zeigt derselbe Wert im Container auf dasselbe Verzeichnis. Fehlt der Wert, gilt der App-Default `./vault_master`.
- Der Bind-Mount ist `read_only: true`, mit `create_host_path: false` (kein stilles Anlegen) und `propagation: rslave`. Ein später wieder eingehängtes NAS wird dadurch im Container sichtbar, sofern der Host-Mountpunkt `shared` ist. - Der Bind-Mount ist `read_only: true`, mit `create_host_path: false` (kein stilles Anlegen) und `propagation: rslave`. Ein später wieder eingehängtes NAS wird dadurch im Container sichtbar, sofern der Host-Mountpunkt `shared` ist.
- **Sentinel:** Standard ist `_system/dictionary/edge_vocabulary.md` relativ zum Vault, einstellbar über `MINDNET_VAULT_SENTINEL`. Liegt sie im Vault der systemd-Instanz woanders, wird `MINDNET_VAULT_SENTINEL` in der Container-Datei gesetzt. - **Sentinel:** Standardmäßig wird nur geprüft, dass der Vault lesbar und nicht leer ist; einen bestimmten Aufbau verlangt der Container nicht (wie systemd). Optional kann `MINDNET_VAULT_SENTINEL` in der Container-Datei eine Datei relativ zum Vault vorschreiben, z. B. `_system/dictionary/edge_vocabulary.md` für den NAS-Vault.
- **NAS beim Start nicht verfügbar:** Die API startet nicht. `restart: unless-stopped` versucht es mit Backoff weiter. Die UI hängt an der gesunden API. - **NAS beim Start nicht verfügbar:** Die API startet nicht. `restart: unless-stopped` versucht es mit Backoff weiter. Die UI hängt an der gesunden API.
- **NAS fällt im Betrieb aus:** Der Healthcheck meldet die API als `unhealthy`. Lesende Abfragen gegen Qdrant laufen weiter. Speichern ist wegen des schreibgeschützten Mounts ohnehin ausgeschlossen. `/ingest/save` würde ohne `ro` den fehlenden Vault-Ordner per `os.makedirs` neu anlegen; genau das verhindert der Mount. - **NAS fällt im Betrieb aus:** Der Healthcheck meldet die API als `unhealthy`. Lesende Abfragen gegen Qdrant laufen weiter. Speichern ist wegen des schreibgeschützten Mounts ohnehin ausgeschlossen. `/ingest/save` würde ohne `ro` den fehlenden Vault-Ordner per `os.makedirs` neu anlegen; genau das verhindert der Mount.
- **Berechtigungen:** Der Container läuft als UID 10001. Der Vault muss für diese UID **lesbar** sein, z. B. über `others: r-x` oder eine passende Gruppe auf dem NAS-Export. Bei CIFS-Mounts gelten `uid`/`gid`/`file_mode` aus den Mount-Optionen des Hosts. Prüfen, ohne am NAS etwas zu ändern: - **Berechtigungen:** Der Container läuft als UID 10001. Der Vault muss für diese UID **lesbar** sein, z. B. über `others: r-x` oder eine passende Gruppe auf dem NAS-Export. Bei CIFS-Mounts gelten `uid`/`gid`/`file_mode` aus den Mount-Optionen des Hosts. Prüfen, ohne am NAS etwas zu ändern:
@@ -153,7 +153,7 @@ Einen Import startet der Container-Workflow nicht; die Daten sind dieselben wie
## 8. Gitea-Pipeline: `develop` → Dev, `main` → Prod ## 8. Gitea-Pipeline: `develop` → Dev, `main` → Prod
Gleiches Muster wie Kansho, aber auf dem eigenen Runner des Zielhosts (heute llm-node, Label `linux_host`, laut [Server-Handbuch](04_server_operation_manual.md) als `root`). Gitea führt nur `.gitea/workflows/` aus: Gleiches Muster wie Kansho, aber auf dem eigenen Runner des Zielhosts (heute llm-node, Label `linux_host`, läuft als `llmadmin`, nicht wie im [Server-Handbuch](04_server_operation_manual.md) angegeben als `root`). Gitea führt nur `.gitea/workflows/` aus:
| Workflow | Trigger | Status | | Workflow | Trigger | Status |
| --- | --- | --- | | --- | --- | --- |
+18 -6
View File
@@ -107,13 +107,11 @@ def test_no_cloud_keys_needs_no_ack(env):
# --- Vault / NAS ----------------------------------------------------------------------- # --- Vault / NAS -----------------------------------------------------------------------
def _vault(tmp_path, with_sentinel=True): def _vault(tmp_path, with_content=True):
root = tmp_path / "vault" root = tmp_path / "vault"
root.mkdir() root.mkdir()
if with_sentinel: if with_content:
sentinel = root / "_system" / "dictionary" / "edge_vocabulary.md" (root / "notiz.md").write_text("# Notiz", encoding="utf-8")
sentinel.parent.mkdir(parents=True)
sentinel.write_text("# vocab", encoding="utf-8")
return root return root
@@ -125,7 +123,21 @@ def test_vault_missing_directory(env, tmp_path):
def test_vault_empty_mountpoint_is_detected(env, tmp_path): def test_vault_empty_mountpoint_is_detected(env, tmp_path):
# Ausgefallenes NAS: Mountpunkt existiert, ist aber leer. # Ausgefallenes NAS: Mountpunkt existiert, ist aber leer.
env.setenv("MINDNET_VAULT_ROOT", str(_vault(tmp_path, with_sentinel=False))) env.setenv("MINDNET_VAULT_ROOT", str(_vault(tmp_path, with_content=False)))
with pytest.raises(ep.PreflightError, match="leer"):
ep.check_vault()
def test_vault_needs_no_specific_file_by_default(env, tmp_path):
# Wie systemd: jeder Vault-Aufbau ist zulässig (vault_master hat kein _system/).
env.setenv("MINDNET_VAULT_ROOT", str(_vault(tmp_path)))
env.setattr(ep, "_is_read_only_mount", lambda path: True)
ep.check_vault()
def test_vault_optional_sentinel_is_enforced(env, tmp_path):
env.setenv("MINDNET_VAULT_ROOT", str(_vault(tmp_path)))
env.setenv("MINDNET_VAULT_SENTINEL", "_system/dictionary/edge_vocabulary.md")
with pytest.raises(ep.PreflightError, match="Sentinel"): with pytest.raises(ep.PreflightError, match="Sentinel"):
ep.check_vault() ep.check_vault()