learning_ai_common_plat/docs
saravanakumardb1 8a568932b4 feat(infra): add production-grade k3s Kubernetes setup for single VM
Complete K8s deployment alternative to Docker Compose, targeting
~50 beta users on a Standard_D8s_v5 Azure VM (8 vCPU, 32 GB RAM).

setup-k8s.sh (6 phases):
  1. Pre-flight: verify docker phases 1-5 ran, disk/RAM checks
  2. Install k3s: Docker runtime, NodePort range 1024-32767
  3. Build images: docker compose build + tag as bytelyst/<svc>
  4. Config: namespaces, ConfigMap (3 copies), Secrets (JWT + blob keys), Ollama
  5. Deploy: infra -> platform -> dashboards -> products (ordered)
  6. Health check: 32 endpoints + kubectl pod status

K8s manifests (18 files):
  - 4 namespaces (infra, platform, dashboards, products)
  - 6 infra (cosmos StatefulSet+PVC, azurite StatefulSet+PVC,
    mailpit, loki StatefulSet+PVC, grafana+PVC, ollama external)
  - 3 platform (Deployment+Service+NodePort each)
  - 2 dashboards (Deployment+Service+NodePort each)
  - 10 backends + 9 webs (all with readiness+liveness probes,
    resource limits, product-specific NEXT_PUBLIC_* env vars)

Design decisions:
  - k3s --docker: reuses existing Docker images, no containerd import
  - Same ports as Docker Compose (NodePort with extended range)
  - ConfigMap replaces .env.ecosystem, copied to 3 app namespaces
  - Blob storage keys injected at deploy time via Secret (not in YAML)
  - Cross-namespace DNS: <svc>.<ns>.svc for service discovery
  - Ollama as Endpoints+Service pointing to host node IP
  - Resource limits: ~19 Gi total, fits in 32 GB with 13 GB headroom
  - Teardown: --teardown flag deletes namespaces, keeps k3s
2026-03-24 14:47:17 -07:00
..
architecture docs(inventory): refresh platform and workspace capability maps 2026-03-05 22:59:45 -08:00
audits docs(audit): add FlowMonk workspace audit and refresh inventory 2026-03-10 22:29:11 -07:00
design docs: complete Platform Acceleration Roadmap (all 4 phases) — move to completed/ 2026-03-19 22:13:21 -07:00
design-system docs: design system audit, onboarding guide, and AGENTS.md updates 2026-03-03 21:55:02 -08:00
devops feat(infra): add production-grade k3s Kubernetes setup for single VM 2026-03-24 14:47:17 -07:00
guides ci: update CI/CD configuration 2026-03-03 12:08:22 -08:00
MCP+A2A docs: Update EXECUTION_CHECKLIST.md with Phase 15 completion 2026-03-05 22:07:53 -08:00
pnpm docs(pnpm): add MindLyst to migration tracker, update Gitea registry status 2026-03-24 08:28:11 -07:00
roadmaps docs: mark Cross-Repo DRY Migration roadmap as COMPLETE (all 5 phases) 2026-03-20 18:58:31 -07:00
session-logs docs: reorganize docs/ into category folders with roadmaps/{completed,partial,not-started} 2026-03-01 23:17:15 -08:00
workstreams docs(workstreams): align checklist with service consolidation 2026-02-15 08:58:58 -08:00
BROADCAST_SURVEY_API_REFERENCE.md docs(broadcasts,surveys): Complete API reference documentation 2026-03-03 08:28:15 -08:00
CROSS_REPO_DRY_AUDIT.md docs: fix 10 inaccuracies in DRY audit + roadmap after thorough review 2026-03-20 07:15:07 -07:00
DASHBOARD_UI_COVERAGE_ROADMAP.md docs: fix 10 bugs in dashboard UI coverage roadmap — self-audit corrections 2026-03-21 17:35:30 -07:00
DASHBOARD_UI_GAP_ANALYSIS.md docs(admin-web): update gap analysis — all Q1-Q4 TODOs resolved, 0 partially exposed pages 2026-03-21 23:15:24 -07:00
ECOSYSTEM_CONSISTENCY_AUDIT.md docs: add ecosystem consistency audit — 20 findings across 13 repos 2026-03-21 20:21:06 -07:00
learning_ai_common_plat_INVENTORY.md docs: update workspace + common-plat inventory with accurate scan data 2026-03-21 10:52:31 -07:00
MOBILE_DRY_REFACTORING_ROADMAP.md docs: Add post-implementation review fixes section to roadmap 2026-03-20 23:16:19 -07:00
PROTOTYPE_DEPLOYMENT.md Add host-side prototype smoke test command 2026-03-14 06:23:18 +00:00
UNIFIED_BYTELYST_PORTAL_PRD.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
UNIFIED_BYTELYST_PORTAL_ROADMAP.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
WORKSPACE_INVENTORY.md docs: update workspace + common-plat inventory with accurate scan data 2026-03-21 10:52:31 -07:00
WORKSPACE_TODO_AUDIT.md fix(exports): strip data payload from list endpoint + update audit doc 2026-03-22 01:23:08 -07:00