KubeSphere — Multi-Cluster Kubernetes Platform

What it is

KubeSphere is an open-source container platform that layers multi-tenancy, DevOps pipelines, service mesh, observability, and an application store on top of any standard Kubernetes cluster. It provides a web console that simplifies Kubernetes management for teams who need enterprise features without building custom tooling.

Platform engineering teams managing multi-tenant clusters, DevOps teams needing integrated CI/CD, and organizations running Kubernetes across multiple clusters use KubeSphere as their management layer. It works with any Kubernetes distribution including EKS, GKE, AKS, and self-managed clusters.

How it saves time or tokens

Managing Kubernetes at scale requires assembling separate tools for CI/CD (Jenkins/Argo), monitoring (Prometheus/Grafana), service mesh (Istio), and access control. KubeSphere integrates all of these into a single platform with a unified UI. Multi-tenancy with workspace-level isolation is built in, eliminating custom RBAC configuration for tenant separation.

How to use

1. Install KubeSphere on an existing cluster:

kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.4.1/kubesphere-installer.yaml
kubectl apply -f https://github.com/kubesphere/ks-installer/releases/download/v3.4.1/cluster-configuration.yaml

1. Wait for installation to complete:

kubectl logs -n kubesphere-system $(kubectl get pod -n kubesphere-system -l app=ks-installer -o jsonpath='{.items[0].metadata.name}') -f

1. Access the console at http://<node-ip>:30880 with default credentials (admin/P@88w0rd).
2. Enable optional components (DevOps, service mesh, monitoring) through the console settings.

Example

# cluster-configuration.yaml -- enable components
apiVersion: installer.kubesphere.io/v1alpha1
kind: ClusterConfiguration
metadata:
  name: ks-installer
  namespace: kubesphere-system
spec:
  devops:
    enabled: true         # Jenkins-based CI/CD pipelines
  servicemesh:
    enabled: true         # Istio service mesh
  monitoring:
    enabled: true         # Prometheus + Grafana
  logging:
    enabled: true         # Fluentd + Elasticsearch
  alerting:
    enabled: true         # Alert management
  multicluster:
    clusterRole: host     # Multi-cluster management

Related on TokRepo

• DevOps Tools -- explore DevOps and infrastructure tools
• Monitoring Tools -- discover monitoring and observability platforms

Common pitfalls

• KubeSphere installs many components. Each enabled feature (DevOps, mesh, monitoring) adds resource overhead. Start with core features and enable additional components as needed.
• The default admin password should be changed immediately after first login. The default credentials are well-known and pose a security risk.
• Multi-cluster management requires network connectivity between clusters. Ensure firewall rules allow the KubeSphere control plane to reach member clusters.