Skip to content

DEPLOY.md

Latest commit

 

History

History
59 lines (43 loc) · 2.57 KB

DEPLOY.md

File metadata and controls

59 lines (43 loc) · 2.57 KB
Raw

KAiOSS Deployment

Schnellstart im Container (für alle, die das Repo frisch klonen)

Voraussetzung: Podman + podman-compose (oder Docker + Compose — die Dateien sind kompatibel).

git clone https://github.com/diebugger-tech/KAiOSS.git
cd KAiOSS
make podman-up        # oder: docker compose up -d --build

Danach:

Der Stack besteht aus vier Services (compose.yaml):

Service Aufgabe
surrealdb SurrealDB v3.0.5 (gepinnt, siehe ADR-001), Daten im Volume
db-schema Einmaliger Import von db/init_clean.surql (Schema + Rechte)
db-seed Einmaliger Import von db/seed.surql (Demo-Projekte)
app SvelteKit-Frontend (adapter-node, Port 5174)

Stoppen mit make podman-down — das Datenvolume kaioss-data bleibt erhalten.

Wichtig zu wissen

  • VITE_-Variablen werden zur Build-Zeit eingebacken. Der Browser verbindet sich direkt mit SurrealDB; der Default zeigt auf ws://127.0.0.1:8000/rpc (der vom Stack veröffentlichte Port). Andere Ziele per Build-Arg: podman build --build-arg VITE_SURREAL_URL=ws://mein-host:8000/rpc -t kaioss-app .
  • Demo-Zugangsdaten (root/root) sind nur für lokale Evaluation gedacht. Für alles Ernsthafte: eigene Credentials setzen (Compose-command + Build-Args).
  • Die Container-Variante enthält nur Demo-Daten. Persönliche Projektdaten liegen ausschließlich in der lokalen data/ bzw. in .project.toml-Dateien außerhalb dieses Repos und sind via .gitignore/.containerignore ausgeschlossen.

Lokale Entwicklung (ohne Container)

make start      # SurrealDB (surrealkv://./data) + Vite Dev-Server, detached
./start.sh stop # stoppen

start.sh prüft vor dem DB-Start die SurrealDB-Version gegen die gepinnte 3.0.5 (ADR-001) — Manifest-Inkompatibilität war am 08.07.2026 Ausfallursache.

Branch-Modell

Branch Zweck
main Stabiler, öffentlicher Stand — das, was Fremde klonen und starten
dev Aktiver Arbeitsbranch — Feature-Arbeit, wird periodisch nach main gemerged

Feature-Branches (z. B. feature/...) zweigen von dev ab und werden dorthin zurückgemerged. Direkte Pushes auf main sind zu vermeiden (HITL-Prinzip).