1. Release Notes
    1. Release Notes - 2.1.1Latest
    1. Release Notes - 2.1.0
    1. Release Notes - 2.0.2
    1. Release Notes - 2.0.1
    1. Release Notes - 2.0.0
  1. Introduction
    1. Introduction
    1. Features
    1. Architecture
    1. Advantages
    1. Glossary
  1. Installation
    1. Introduction
      1. Intro
      2. Port Requirements
      3. Kubernetes Cluster Configuration
    1. Install on Linux
      1. All-in-One Installation
      2. Multi-Node Installation
      3. High Availability Configuration
      4. Air Gapped Installation
      5. StorageClass Configuration
      6. Enable All Components
    1. Install on Kubernetes
      1. Prerequisites
      2. Install on K8s
      3. Air Gapped Installation
      4. Install on GKE
    1. Pluggable Components
      1. Pluggable Components
      2. Enable Application Store
      3. Enable DevOps System
      4. Enable Logging System
      5. Enable Service Mesh
      6. Enable Alerting and Notification
      7. Enable Metrics-server for HPA
      8. Verify Components Installation
    1. Upgrade
      1. Overview
      2. All-in-One
      3. Multi-node
    1. Third-Party Tools
      1. Configure Harbor
      2. Access Built-in SonarQube and Jenkins
      3. Enable built-in Grafana Installation
      4. Load Balancer plugin in Bare Metal - Porter
    1. Authentication Integration
      1. Configure LDAP/AD
    1. Cluster Operations
      1. Add or Cordon Nodes
      2. High Risk Operations
      3. Uninstall KubeSphere
  1. Quick Start
    1. 1. Getting Started with Multi-tenancy
    1. 2. Expose your App Using Ingress
    1. 3. Compose and Deploy Wordpress to K8s
    1. 4. Deploy Grafana Using App Template
    1. 5. Job to Compute π to 2000 Places
    1. 6. Create Horizontal Pod Autoscaler
    1. 7. S2I: Publish your App without Dockerfile
    1. 8. B2I: Publish Artifacts to Kubernete
    1. 9. CI/CD based on Spring Boot Project
    1. 10. Jenkinsfile-free Pipeline with Graphical Editing Panel
    1. 11. Canary Release of Bookinfo App
    1. 12. Canary Release based on Ingress-Nginx
    1. 13. Application Store
  1. DevOps
    1. Pipeline
    1. Create SonarQube Token
    1. Credentials
    1. Set CI Node for Dependency Cache
    1. Set Email Server for KubeSphere Pipeline
  1. User Guide
    1. Configration Center
      1. Secrets
      2. ConfigMap
      3. Configure Image Registry
  1. Logging
    1. Log Query
  1. Developer Guide
    1. Introduction to S2I
    1. Custom S2I Template
  1. API Documentation
    1. API Documentation
    1. How to Access KubeSphere API
  1. Troubleshooting
    1. Troubleshooting Guide for Installation
  1. FAQ
    1. Telemetry
KubeSphere®️ 2020 All Rights Reserved.

Release Notes For 2.0.0


KubeSphere 2.0.0 was released on May 18th, 2019.

What's New in 2.0.0

Component Upgrades

  • Support Kubernetes Kubernetes 1.13.5
  • Integrate QingCloud Cloud Controller. After installing load balancer, QingCloud load balancer can be created through KubeSphere console and the backend workload is bound automatically. 
  • Integrate QingStor CSI v0.3.0 storage plugin and support physical NeonSAN storage system. Support SAN storage service with high availability and high performance.
  • Integrate QingCloud CSI v0.2.1 storage plugin and support many types of volume to create QingCloud block services.
  • Harbor is upgraded to 1.7.5.
  • GitLab is upgraded to 11.8.1.
  • Prometheus is upgraded to 2.5.0.

Microservice Governance

  • Integrate Istio 1.1.1 and support visualization of service mesh management.
  • Enable the access to the project's external websites and the application traffic governance.
  • Provide built-in sample microservice Bookinfo Application.
  • Support traffic governance.
  • Support traffic images.
  • Provide load balancing of microservice based on Istio.
  • Support canary release.
  • Enable blue-green deployment.
  • Enable circuit breaking.
  • Enable microservice tracing.

DevOps (CI/CD Pipeline)

  • CI/CD pipeline provides email notification and supports the email notification during construction.
  • Enhance CI/CD graphical editing pipelines, and more pipelines for common plugins and execution conditions.
  • Provide source code vulnerability scanning based on SonarQube 7.4.
  • Support Source to Image feature.


  • Provide Kubernetes component independent monitoring page including etcd, kube-apiserver and kube-scheduler.
  • Optimize several monitoring algorithm.
  • Optimize monitoring resources. Reduce Prometheus storage and the disk usage up to 80%.


  • Provide unified log console in terms of tenant.
  • Enable accurate and fuzzy retrieval.
  • Support real-time and history logs.
  • Support combined log query based on namespace, workload, Pod, container, key words and time limit.  
  • Support detail page of single and direct logs. Pods and containers can be switched.
  • FluentBit Operator supports logging gathering settings: ElasticSearch, Kafka and Fluentd can be added, activated or turned off as log collectors. Before sending to log collectors, you can configure filtering conditions for needed logs.

Alerting and Notifications

  • Email notifications are available for cluster nodes and workload resources. 
  • Notification rules: combined multiple monitoring resources are available. Different warning levels, detection cycle, push times and threshold can be configured.
  • Time and notifiers can be set.
  • Enable notification repeating rules for different levels.

Security Enhancement

  • Fix RunC Container Escape Vulnerability Runc container breakout
  • Fix Alpine Docker's image Vulnerability Alpine container shadow breakout
  • Support single and multi-login configuration items.
  • Verification code is required after multiple invalid logins.
  • Enhance passwords' policy and prevent weak passwords.
  • Others security enhancements.

Interface Optimization

  • Optimize multiple user experience of console, such as the switch between DevOps project and other projects.
  • Optimize many Chinese-English webpages.


  • Support Etcd backup and recovery.
  • Support regular cleanup of the docker's image.

Bugs Fixes

  • Fix delay updates of the resource and deleted pages.
  • Fix the left dirty data after deleting the HPA workload.
  • Fix incorrect Job status display.
  • Correct resource quota, Pod usage and storage metrics algorithm.
  • Adjust CPU usage percentages.
  • many more bugfix