Home

Awesome

<p align="center"> <a href="https://kubesphere.io/"><img src="docs/images/kubesphere-icon.gif" alt="banner" width="200px"></a> </p> <p align="center"> <b>The container platform tailored for <i>Kubernetes multi-cloud, datacenter, and edge</i> management</b> </p> <p align=center> <a href="https://goreportcard.com/report/github.com/kubesphere/kubesphere"><img src="https://goreportcard.com/badge/github.com/kubesphere/kubesphere" alt="A+"></a> <a href="https://hub.docker.com/r/kubesphere/ks-installer"><img src="https://img.shields.io/docker/pulls/kubesphere/ks-installer"></a> <a href="https://github.com/kubesphere/kubesphere/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22"><img src="https://img.shields.io/github/issues/kubesphere/kubesphere/good%20first%20issue?logo=github" alt="good first issue"></a> <a href="https://twitter.com/intent/follow?screen_name=KubeSphere"><img src="https://img.shields.io/twitter/follow/KubeSphere?style=social" alt="follow on Twitter"></a> <a href="https://join.slack.com/t/kubesphere/shared_invite/zt-219hq0b5y-el~FMRrJxGM1Egf5vX6QiA"><img src="https://img.shields.io/badge/Slack-2000%2B-blueviolet?logo=slack&amp;logoColor=white"></a> <a href="https://www.youtube.com/channel/UCyTdUQUYjf7XLjxECx63Hpw"><img src="https://img.shields.io/youtube/channel/subscribers/UCyTdUQUYjf7XLjxECx63Hpw?style=social"></a> </p>

What is KubeSphere

English | ไธญๆ–‡

KubeSphere is a distributed operating system for cloud-native application management, using Kubernetes as its kernel. It provides a plug-and-play architecture, allowing third-party applications to be seamlessly integrated into its ecosystem. KubeSphere is also a multi-tenant container platform with full-stack automated IT operation and streamlined DevOps workflows. It provides developer-friendly wizard web UI, helping enterprises to build out a more robust and feature-rich platform, which includes most common functionalities needed for enterprise Kubernetes strategy, see Feature List for details.

The following screenshots give a close insight into KubeSphere. Please check What is KubeSphere for further information.

<table> <tr> <td width="50%" align="center"><b>Workbench</b></td> <td width="50%" align="center"><b>Project Resources</b></td> </tr> <tr> <td><img src="docs/images/console.png"/></td> <td><img src="docs/images/project.png"/></td> </tr> <tr> <td width="50%" align="center"><b>CI/CD Pipeline</b></td> <td width="50%" align="center"><b>App Store</b></td> </tr> <tr> <td><img src="docs/images/cicd.png"/></td> <td><img src="docs/images/app-store.png"/></td> </tr> </table>

Demo environment

๐ŸŽฎ KubeSphere Lite provides you with free, stable, and out-of-the-box managed cluster service. After registration and login, you can easily create a K8s cluster with KubeSphere installed in only 5 seconds and experience feature-rich KubeSphere.

๐Ÿ–ฅ You can view the Demo Video to get started with KubeSphere.

Features

<details> <summary><b>๐Ÿ•ธ Provisioning Kubernetes Cluster</b></summary> Support deploy Kubernetes on any infrastructure, support online and air-gapped installation. <a href="https://kubesphere.io/docs/installing-on-linux/introduction/intro/">Learn more</a>. </details> <details> <summary><b>๐Ÿ”— Kubernetes Multi-cluster Management</b></summary> Provide a centralized control plane to manage multiple Kubernetes clusters, and support the ability to propagate an app to multiple K8s clusters across different cloud providers. </details> <details> <summary><b>๐Ÿค– Kubernetes DevOps</b></summary> Provide GitOps-based CD solutions and use Argo CD to provide the underlying support, collecting CD status information in real time. With the mainstream CI engine Jenkins integrated, DevOps has never been easier. <a href="https://kubesphere.io/devops/">Learn more</a>. </details> <details> <summary><b>๐Ÿ”Ž Cloud Native Observability</b></summary> Multi-dimensional monitoring, events and auditing logs are supported; multi-tenant log query and collection, alerting and notification are built-in. <a href="https://kubesphere.io/observability/">Learn more</a>. </details> <details> <summary><b>๐Ÿงฉ Service Mesh (Istio-based)</b></summary> Provide fine-grained traffic management, observability and tracing for distributed microservice applications, provides visualization for traffic topology. <a href="https://kubesphere.io/service-mesh/">Learn more</a>. </details> <details> <summary><b>๐Ÿ’ป App Store</b></summary> Provide an App Store for Helm-based applications, and offer application lifecycle management on Kubernetes platform. <a href="https://kubesphere.io/docs/pluggable-components/app-store/">Learn more</a>. </details> <details> <summary><b>๐Ÿ’ก Edge Computing Platform</b></summary> KubeSphere integrates <a href="https://kubeedge.io/en/">KubeEdge</a> to enable users to deploy applications on the edge devices and view logs and monitoring metrics of them on the console. <a href="https://kubesphere.io/docs/pluggable-components/kubeedge/">Learn more</a>. </details> <details> <summary><b>๐Ÿ“Š Metering and Billing</b></summary> Track resource consumption at different levels on a unified dashboard, which helps you make better-informed decisions on planning and reduce the cost. <a href="https://kubesphere.io/docs/toolbox/metering-and-billing/view-resource-consumption/">Learn more</a>. </details> <details> <summary><b>๐Ÿ—ƒ Support Multiple Storage and Networking Solutions</b></summary> <li>Support GlusterFS, CephRBD, NFS, LocalPV solutions, and provide CSI plugins to consume storage from multiple cloud providers.</li><li>Provide Load Balancer Implementation <a href="https://github.com/kubesphere/openelb">OpenELB</a> for Kubernetes in bare-metal, edge, and virtualization.</li><li> Provides network policy and Pod IP pools management, support Calico, Flannel, Kube-OVN</li>.</li>. </details> <details> <summary><b>๐Ÿ˜ Multi-tenancy</b></summary> Provide unified authentication with fine-grained roles and three-tier authorization system, and support AD/LDAP authentication. </details> <details> <summary><b>๐Ÿง  GPU Workloads Scheduling and Monitoring</b></summary> Create GPU workloads on the GUI, schedule GPU resources, and manage GPU resource quotas by tenant. </details>

Architecture

KubeSphere uses a loosely-coupled architecture that separates the frontend from the backend. External systems can access the components of the backend through the REST APIs.

Architecture


Latest release

๐ŸŽ‰ KubeSphere v3.4.0 was released! It brings enhancements and better user experience, see the Release Notes For 3.4.0 for the updates.

Component supported versions table

ComponentVersionK8s supported version
AlertingN/A1.21,1.22,1.23,1.24,1.25,1.26
Auditingv0.2.01.21,1.22,1.23,1.24,1.25,1.26
MonitoringN/A1.21,1.22,1.23,1.24,1.25,1.26
DevOpsv3.4.01.21,1.22,1.23,1.24,1.25,1.26
EdgeRuntimev1.13.01.21,1.22,1.23
EventsN/A1.21,1.22,1.23,1.24,1.25,1.26
Loggingopensearch๏ผšv2.6.0<br/>fluentbit-operator: v0.14.0<br/> fluent-bit-tag: v1.9.41.21,1.22,1.23,1.24,1.25,1.26
Metrics Serverv0.4.21.21,1.22,1.23,1.24,1.25,1.26
NetworkN/A1.21,1.22,1.23,1.24,1.25,1.26
Notificationv2.3.01.21,1.22,1.23,1.24,1.25,1.26
AppStoreN/A1.21,1.22,1.23,1.24,1.25,1.26
Storagepvc-autoresizer: v0.3.0<br/>storageclass-accessor: v0.2.21.21,1.22,1.23,1.24,1.25,1.26
ServiceMeshIstio: v1.14.61.21,1.22,1.23,1.24
GatewayIngress NGINX Controller: v1.3.11.21,1.22,1.23,1.24

Installation

KubeSphere can run anywhere from on-premise datacenter to any cloud to edge. In addition, it can be deployed on any version-compatible Kubernetes cluster. The installer will start a minimal installation by default, you can enable other pluggable components before or after installation.

Quick start

Installing on K8s/K3s

Ensure that your cluster has installed Kubernetes v1.21.x, v1.22.x, v1.23.x, * v1.24.x, * v1.25.x, or * v1.26.x. For Kubernetes versions with an asterisk, some features may be unavailable due to incompatibility.

Run the following commands to install KubeSphere on an existing Kubernetes cluster:

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

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

All-in-one

๐Ÿ‘จโ€๐Ÿ’ป No Kubernetes? You can use KubeKey to install both KubeSphere and Kubernetes/K3s in single-node mode on your Linux machine. Let's take K3s as an example:

# Download KubeKey
curl -sfL https://get-kk.kubesphere.io | VERSION=v3.0.10 sh -
# Make kk executable
chmod +x kk
# Create a cluster
./kk create cluster --with-kubernetes v1.24.14 --container-manager containerd --with-kubesphere v3.4.0

You can run the following command to view the installation logs. After KubeSphere is successfully installed, you can access the KubeSphere web console at http://IP:30880 and log in using the default administrator account ( admin/P@88w0rd).

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

KubeSphere for hosted Kubernetes services

KubeSphere is hosted on the following cloud providers, and you can try KubeSphere by one-click installation on their hosted Kubernetes services.

You can also install KubeSphere on other hosted Kubernetes services within minutes, see the step-by-step guides to get started.

๐Ÿ‘จโ€๐Ÿ’ป No internet access? Refer to

the Air-gapped Installation on Kubernetes

or Air-gapped Installation on Linux

for instructions on how to use private registry to install KubeSphere.

Guidance, discussion, contribution, and support

We :heart: your contribution. The community walks you through how to get started contributing KubeSphere. The development guide explains how to set up development environment.

:hugs: Please submit any KubeSphere bugs, issues, and feature requests to KubeSphere GitHub Issue.

:heart_decoration: The KubeSphere team also provides efficient official ticket support to respond in hours. For more information, click KubeSphere Online Support.

Who are using KubeSphere

The user case studies page includes the user list of the project. You can leave a comment to let us know your use case.

Landscapes

<p align="center"> <br/><br/> <img src="https://landscape.cncf.io/images/left-logo.svg" width="150"/>&nbsp;&nbsp;<img src="https://landscape.cncf.io/images/right-logo.svg" width="200"/>&nbsp;&nbsp; <br/><br/> KubeSphere is a member of CNCF and a <a href="https://www.cncf.io/certification/software-conformance/#logos">Kubernetes Conformance Certified platform </a>, which enriches the <a href="https://landscape.cncf.io/?landscape=observability-and-analysis&license=apache-license-2-0">CNCF CLOUD NATIVE Landscape. </a> </p>