How weibaohui/k8m works
K8M is an AI-assisted Kubernetes management console. Users sign in, select a connected cluster, and use the web console or APIs to inspect and manage Kubernetes resources; backend controllers call the Kubernetes client and return results. Major documented branches include AI diagnosis, Helm, inspections, event forwarding, MCP, and API keys. Relationships for unsampled features are documented rather than inferred from module names; source-level detail is limited to the excerpts and SOURCE INDEX.
Main entry points: main.go HTTP server · manager.go Plugin manager · analysis.go AI analysis · controller.go Event forwarding
Components 25
Console and API
- Web console
ui/src/App.tsx - HTTP server
main.go - Authentication
pkg/middleware/auth.go
Cluster management
- Workload operations
pkg/controller/deploy/deploy.go - Dynamic resources
pkg/controller/dynamic/container.go - YAML editor
pkg/plugins/modules/yaml_editor/controller/controller.go - Storage classes
pkg/controller/storageclass/storage_class.go - Cluster registry
pkg/service/clusters.go
AI and extensions
- AI analysis
pkg/plugins/modules/k8sgpt/service/analysis/analysis.go - AI assistant
pkg/plugins/modules/ai/controller/chat.go - Helm management
pkg/plugins/modules/helm/service/helm.go - Cluster inspection
pkg/plugins/modules/inspection/lua/lua_inspection.go - Event forwarding
pkg/plugins/modules/eventhandler/admin/controller.go - Webhook delivery
pkg/plugins/modules/webhook/service/webhook.go - MCP server
pkg/plugins/modules/k8m_mcp_server/server/server.go - Plugin manager
pkg/plugins/manager.go
Identity and persistence
- Users and permissions
pkg/comm/permission.go - Application database
internal/dao/conn.go - Domain models
pkg/models/migrate.go - API keys
pkg/plugins/modules/openapi/admin/controller.go - HA leases
pkg/plugins/modules/leader/lease/manager.go
Other components
- Operator
- Kubernetes clusters
- AI provider
- Webhook targets
Connections 30
- Operator → Web console: uses
README.md - Web console → HTTP server: sends requests
- HTTP server → Authentication: routes through
- HTTP server → Plugin manager: registers plugins
main.go - HTTP server → Cluster registry: initializes clusters
main.go - Authentication → Users and permissions: checks roles
pkg/middleware/auth.go - Users and permissions → Application database: persists users
- Domain models → Application database: migrates schema
pkg/models/migrate.go - Workload operations → Kubernetes clusters: manages workloads
README.md - Dynamic resources → Kubernetes clusters: manages resources
README.md - YAML editor → Kubernetes clusters: applies manifests
pkg/plugins/modules/yaml_editor/controller/controller.go - Storage classes → Kubernetes clusters: reads and updates
pkg/controller/storageclass/storage_class.go - Cluster registry → Kubernetes clusters: connects clusters
README.md - Operator → AI analysis: requests diagnosis
README.md - AI analysis → Kubernetes clusters: analyzes resources
- AI assistant → AI provider: calls model
README.md - Operator → Helm management: manages charts
README.md - Operator → Cluster inspection: configures checks
README.md - Cluster inspection → Webhook delivery: sends findings
README.md - Operator → Event forwarding: configures forwarding
pkg/plugins/modules/eventhandler/admin/controller.go - Event forwarding → Webhook delivery: delivers events
README.md - Webhook delivery → Webhook targets: posts notifications
README.md - Operator → MCP server: calls tools
README.md - MCP server → Kubernetes clusters: executes cluster tools
README.md - Plugin manager → Event forwarding: manages plugin
- Plugin manager → Helm management: manages plugin
- Plugin manager → AI analysis: manages plugin
- API keys → Users and permissions: creates user tokens
pkg/plugins/modules/openapi/admin/controller.go - API keys → Application database: stores keys
pkg/plugins/modules/openapi/admin/controller.go - HA leases → Kubernetes clusters: coordinates leadership
pkg/plugins/modules/leader/lease/manager.go