KubeOsprey System Architecture

KubeOsprey System Architecture An architecture diagram generated by Archify. User · Browser · Architecture component User Browser React SPA · ui/src · embedded static/ · Architecture component React SPA ui/src · embedded static/ Gin HTTP server · routes.go · middleware chain · KubeOsprey single binary (Go) · Single binary :8080 Gin HTTP server routes.go · middleware chain Single binary :8080 pkg/auth · JWT · OAuth · LDAP · Passkey · KubeOsprey single binary (Go) pkg/auth JWT · OAuth · LDAP · Passkey pkg/rbac · KubeOsprey role model · KubeOsprey single binary (Go) pkg/rbac KubeOsprey role model pkg/resources · ~80 resource APIs · KubeOsprey single binary (Go) pkg/resources ~80 resource APIs ClusterManager · pkg/cluster · ClientSet · KubeOsprey single binary (Go) ClusterManager pkg/cluster · ClientSet Kubernetes API · Target cluster · Target Kubernetes cluster Kubernetes API Target cluster cluster-agent · Subcommand, same binary · Target Kubernetes cluster cluster-agent Subcommand, same binary Prometheus · Metrics · auto-discovery · Target Kubernetes cluster Prometheus Metrics · auto-discovery AI assistant · pkg/ai · SSE tool calls · KubeOsprey single binary (Go) AI assistant pkg/ai · SSE tool calls GORM store · SQLite / MySQL / Postgres · KubeOsprey single binary (Go) GORM store SQLite / MySQL / Postgres HTTPS REST · WebSocket · SSE RequireAuth Load roles RBACMiddleware allows Get ClientSet in-cluster / kubeconfig direct Register + WebSocket tunnel Local forwarding Metrics queries AI session (SSE) Tool calls GORM read/write KubeOsprey single binary (Go) Target Kubernetes cluster Legend Frontend Backend Database Cloud Security External

Request path

  • • SPA reaches resource APIs via the middleware chain
  • • JWT cookie or API key authentication
  • • KubeOsprey RBAC decides, not K8s RBAC

Multi-cluster access

  • • Per-cluster K8s and metrics clients
  • • Direct · kubeconfig · agent modes
  • • Cluster config hot-synced every minute

AI and security

  • • AI tools reuse the user's own RBAC
  • • Mutations require human confirmation
  • • Sensitive config encrypted at rest (AES-GCM)