Add reachability checks and develop/main container pipeline (inactive)

- preflight --live: Ollama/Qdrant reachable from the container, required
  Ollama models present, 768 dimensions; clear abort instead of traceback.
  Static check rejects unset or container-local service URLs.
- deploy/smoke.py: non-writing post-start check via published ports.
- deploy/deploy.sh: test (no network), build, preflight, up --wait, smoke;
  prod rolls back to the last good image tag.
- Workflow templates deploy-dev.yml (push develop) and deploy-prod.yml
  (push main) following the Kansho pattern; not under .gitea/workflows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-10-28 16:01:37 +01:00
1 parent 7a225ba2b6
commit 8f9f83aa79
14 files changed
+728 -90

No files matched your search

+113
View File
@@ -0,0 +1,113 @@
"""
FILE: deploy/smoke.py
DESCRIPTION: Nicht-schreibender Smoke-Test gegen einen laufenden Mindnet-Stack,
aus Sicht des Hosts über die veröffentlichten Ports. Nur Standardbibliothek,
läuft daher direkt auf dem Runner (python3), ohne venv.
- API /healthz: Status ok, erwartetes Collection-Präfix
- API /admin/stats: Vektorgröße 768; API erreicht Qdrant (Collection-Counts)
- UI /_stcore/health
--require-data (Prod): alle Collections vorhanden und Notes nicht leer.
VERSION: 1.0.0
STATUS: Active
USAGE: smoke.py --api http://127.0.0.1:8012 --ui http://127.0.0.1:8512 --prefix mindnet_dev [--require-data]
"""
from __future__ import annotations
import argparse
import json
import sys
import time
import urllib.error
import urllib.request
EXPECTED_VECTOR_SIZE = 768
class SmokeError(RuntimeError):
pass
def _get(url: str, timeout: float = 15) -> bytes:
try:
with urllib.request.urlopen(url, timeout=timeout) as res:
return res.read()
except urllib.error.HTTPError as e:
raise SmokeError(f"{url}: HTTP {e.code}") from None
except (urllib.error.URLError, OSError) as e:
raise SmokeError(f"{url} nicht erreichbar ({getattr(e, 'reason', e)})") from None
def _get_json(url: str) -> dict:
try:
return json.loads(_get(url))
except ValueError:
raise SmokeError(f"{url} liefert kein JSON") from None
def check_api(api: str, prefix: str, require_data: bool) -> list[str]:
"""Gibt Warnungen zurück; harte Fehler als SmokeError."""
health = _get_json(f"{api}/healthz")
if health.get("status") != "ok":
raise SmokeError(f"/healthz meldet {health.get('status')!r}")
if health.get("prefix") != prefix:
raise SmokeError(f"API nutzt Präfix {health.get('prefix')!r}, erwartet {prefix!r}")
stats = _get_json(f"{api}/admin/stats")
size = (stats.get("config") or {}).get("vector_size")
if size != EXPECTED_VECTOR_SIZE:
raise SmokeError(f"API-Vektorgröße {size}, erwartet {EXPECTED_VECTOR_SIZE}")
warnings = []
collections = stats.get("collections") or {}
for kind in ("notes", "chunks", "edges"):
entry = collections.get(kind) or {}
count = entry.get("count", -1)
if count < 0:
# -1: Collection fehlt oder Qdrant ist aus dem API-Container nicht erreichbar.
msg = f"Collection {entry.get('name', kind)!r} nicht lesbar (fehlt oder Qdrant nicht erreichbar)"
if require_data:
raise SmokeError(msg)
warnings.append(msg)
if require_data and (collections.get("notes") or {}).get("count", 0) <= 0:
raise SmokeError("Notes-Collection ist leer")
return warnings
def check_ui(ui: str) -> None:
body = _get(f"{ui}/_stcore/health").decode("utf-8", "replace").strip()
if body != "ok":
raise SmokeError(f"UI-Health meldet {body!r}")
def run(api: str, ui: str, prefix: str, require_data: bool = False, attempts: int = 1, delay: float = 5) -> int:
api, ui = api.rstrip("/"), ui.rstrip("/")
for attempt in range(1, attempts + 1):
try:
warnings = check_api(api, prefix, require_data)
check_ui(ui)
except SmokeError as e:
if attempt == attempts:
print(f"smoke: FEHLER: {e}", file=sys.stderr)
return 1
time.sleep(delay)
continue
for w in warnings:
print(f"smoke: WARNUNG: {w}")
print(f"smoke: OK (api={api}, ui={ui}, prefix={prefix})")
return 0
return 1
def main(argv: list[str] | None = None) -> int:
parser = argparse.ArgumentParser(description=__doc__.split("USAGE:")[0])
parser.add_argument("--api", required=True)
parser.add_argument("--ui", required=True)
parser.add_argument("--prefix", required=True)
parser.add_argument("--require-data", action="store_true")
parser.add_argument("--attempts", type=int, default=3)
args = parser.parse_args(argv)
return run(args.api, args.ui, args.prefix, args.require_data, args.attempts)
if __name__ == "__main__":
sys.exit(main())