How kubesphere/kubesphere works
KubeSphere Core is the Kubernetes-backed control plane of a broader extensible container platform. A user request enters the API server, passes authentication and authorization filters, and reaches domain handlers for applications, clusters, resources, or tenant/IAM operations. Models provide resource-oriented access, while controllers reconcile persistent objects and propagate selected state to member clusters. The README also describes dynamically managed extensions and Helm application lifecycle management. Sampled controller excerpts confirm app-release, install-plan, cluster, and workspace reconciliation; most handler-to-model wiring and other feature internals were not sampled.
Main entry points: manager.go Controller manager · models Resource models · filters.go Request filters · apprelease_controller.go Release lifecycle
Components 24
API access
- API server
pkg/apiserver/apiserver.go - Request filters
pkg/apiserver/filters/filters.go - Authentication
pkg/apiserver/filters/authentication.go - Authorization
pkg/apiserver/filters/authorization.go - Domain APIs
pkg/kapis
Core control
- Resource models
pkg/models - Controller manager
pkg/controller/manager.go
Tenant access
- Tenant endpoints
pkg/kapis/tenant/v1beta1/handler.go - IAM endpoints
pkg/kapis/iam/v1beta1/handler.go - Workspace reconciler
pkg/controller/workspacetemplate/workspacetemplate_controller.go - Workspace roles
pkg/controller/workspacerole/workspacerole_controller.go - Role bindings
pkg/controller/workspacerolebinding/workspacerolebinding_controller.go - User lifecycle
pkg/controller/user/user_controller.go
Apps and extensions
- Application endpoints
pkg/kapis/application/v2/handler_app.go - Release lifecycle
pkg/controller/application/apprelease_controller.go - Extension install plans
pkg/controller/core/installplan_controller.go
Clusters and resources
- Cluster endpoints
pkg/kapis/cluster/v1alpha1/handler.go - Cluster reconciler
pkg/controller/cluster/cluster_controller.go - Resource endpoints
pkg/kapis/resources/v1alpha2/handler.go - Quota control
pkg/controller/quota/resourcequota_controller.go - Storage capabilities
pkg/controller/storageclass/storageclass_controller.go
Other components
- Platform user
- Kubernetes clusters
- Helm executor
staging/src/kubesphere.io/utils/helm/executor.go
Connections 29
- Platform user → API server: sends requests
- API server → Request filters: passes through
- Request filters → Authentication: authenticates
- Request filters → Authorization: authorizes
- Request filters → Domain APIs: dispatches requests
- Domain APIs → Resource models: accesses domain data
- Controller manager → Cluster reconciler: runs reconciler
- Controller manager → Workspace reconciler: runs reconciler
- Controller manager → Workspace roles: runs reconciler
- Controller manager → Role bindings: runs reconciler
- Controller manager → User lifecycle: runs reconciler
- Controller manager → Release lifecycle: runs reconciler
- Controller manager → Extension install plans: runs reconciler
- Cluster endpoints → Resource models: reads cluster data
- Resource endpoints → Resource models: reads resource data
- Tenant endpoints → Resource models: accesses tenant data
- IAM endpoints → Resource models: accesses IAM data
- Application endpoints → Resource models: accesses app data
- Cluster reconciler → Kubernetes clusters: reconciles cluster state
- Workspace reconciler → Kubernetes clusters: syncs workspaces
- Workspace roles → Kubernetes clusters: syncs roles
- Role bindings → Kubernetes clusters: syncs bindings
- User lifecycle → Kubernetes clusters: manages user resources
- Quota control → Kubernetes clusters: reconciles quotas
- Storage capabilities → Kubernetes clusters: reads and annotates
- Release lifecycle → Helm executor: manages releases
- Release lifecycle → Kubernetes clusters: tracks release state
- Extension install plans → Helm executor: executes install plans
- Extension install plans → Kubernetes clusters: updates extension state