Kubesphere core
The container platform tailored for Kubernetes multi-cloud, datacenter, and edge management β π₯ βοΈ
npx -y skills add kubesphere/kubesphere --skill kubesphere-coreAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
What its author says it does
Copied from the file, not written here
KubeSphere central controller Skill. Routes to specific Skills based on user requests: multi-cluster management (kubesphere-cluster-management), multi-tenant management (kubesphere-multi-tenant-management), extension management (kubesphere-extension-management). Also provides core architecture, API routing, and API utilities.
SKILL.md
7.0 KB, as published. Nobody here has run it
KubeSphere Core
Overview
KubeSphere is a distributed operating system for cloud-native application management built on Kubernetes. Version 4.x adopts a microkernel + extension architecture (codename LuBan) where the core provides essential functions and independent functional modules are delivered as extensions.
Core Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β KubeSphere Console β
β (React-based Web UI + Extension Framework) β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββ
β KubeSphere Core (LuBan) β
β βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ β
β β Multi-Cluster β β Multi-Tenant β β K8s Resource β β Extension β β Application β β
β β Management β β Management β β Management β β Management β β Management β β
β βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ βββββββββββββββββββββ β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Underlying Kubernetes Clusters β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Core Components
| Component | Description |
|---|---|
| ks-apiserver | API aggregation layer. Acts as the central API entry point for KubeSphere, aggregating APIs from core services and extensions. Handles authentication, authorization, and multi-cluster API routing. |
| ks-controller-manager | Resource controllers. Manages the lifecycle of KubeSphere custom resources (workspaces, projects, users, etc.). Reconciles desired state and handles event-driven operations. |
| ks-console | Web UI. React-based console providing visual management interface for all KubeSphere capabilities. Supports extension framework for custom UI components. |
API
API Path Prefixes
KubeSphere provides two main API path prefixes with different routing behaviors:
| Path Prefix | Routed To | Use Case |
|---|---|---|
/apis/ | kube-apiserver on target cluster | Direct Kubernetes CRUD operations |
/kapis/ | KubeSphere API server | KubeSphere-specific APIs, workspace-scoped operations |
Multi-Cluster API Routing
Use the /clusters/{cluster-name}/ prefix to forward requests to specific member clusters:
# Access member-1 cluster
/clusters/member-1/kapis/tenant.kubesphere.io/v1beta1/workspaces/demo/namespaces
API Script Usage
Use the ks_api.py script to make API calls. The script handles authentication automatically.
Prerequisites:
pip install requests
export KUBESPHERE_HOST="http://<kubesphere-host>"
python scripts/ks_api.py --login --username admin --password <password>
Usage:
# Get token info
python scripts/ks_api.py
# List resources (GET)
python scripts/ks_api.py GET /kapis/tenant.kubesphere.io/v1beta1/workspacetemplates
# Query specific cluster
python scripts/ks_api.py GET /clusters/member-1/kapis/tenant.kubesphere.io/v1beta1/namespaces
# Clear cached token
python scripts/ks_api.py --clear-cache
Skill Routing
kubesphere-core routes to specific Skills based on user requests.
| Skill | Capabilities | Restrictions |
|---|---|---|
kubesphere-core | Architecture, API routing, API utilities | No management operations |
kubesphere-cluster-management | Multi-cluster management | Cluster operations |
kubesphere-multi-tenant-management | Create user/workspace/project, assign roles | No delete, No custom roles |
kubesphere-extension-management | Extension install/upgrade/uninstall | Extension-related only |