< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Release Notes for 3.1.0

How to Install v3.1.0

New Features and Enhancements

Multi-cluster management

  • Simplified the steps to import Member Clusters with configuration validation (for example, jwtSecret) added. (#3232)
  • Refactored the cluster controller and optimized the logic. (#3234)
  • Upgraded the built-in web Kubectl, the version of which is now consistent with your Kubernetes cluster version. (#3103)
  • Support customized resynchronization period of cluster controller. (#3213)
  • Support lightweight installation of Member Clusters without components such as Redis and OpenLDAP. (#3056)
  • Support high availability of Tower agent and server. (#31)

KubeEdge integration

You can now enable KubeEdge in your cluster and manage edge nodes on the KubeSphere console. (#3070)

  • Support the installation of both cloud and edge modules of KubeEdge.
  • Support adding KubeEdge through the KubeSphere console.
  • Support the deployment of workloads on edge nodes.
  • The logs and monitoring data of edge nodes can be collected.
  • The network of edge nodes can be configured automatically as they join or leave a cluster.
  • Taints can be added automatically as an edge node joins your cluster.
  • You can use nodeAffinity to prevent cloud workloads (for example, DaemonSets) from being deployed to edge nodes. (#1295, #1297 and #1300)

Authorization and authentication management

  • Added ServiceAccount management. (#3211)
  • Improved the LDAP authentication plugin and added support for LDAPS and search filtering. (#2970 and #3766)
  • Improved the identify provider plugin and simplified the configuration of identify providers. (#2970)
  • New users now see a prompt to change the old password when first logging in to KubeSphere.
  • New users now need to confirm account information when logging in to KubeSphere through a third party.
  • Support CAS as an available identity provider. (#3047)
  • Support OIDC as an available identity provider. (#2941)
  • Support IDaaS (Alibaba Cloud Identity as a Service) as an available identity provider. (#2997)

Multi-tenant management

  • Users now can configure departments in a workspace and assign users to the department. All users in the department can have the same role in a project or DevOps project. (#2940)
  • Support workspace quotas which are used to manage resource usage of a workspace. (#2939)


  • Added Kube-OVN.
  • Support Calico IP pool management. (#3057)
  • Support visual network topology. (#3061 and #583)
  • A static IP address can be assigned to a Deployment now. (#3058)


  • Improved the current method of Prometheus integration. (#3068 and #1164; guide)
  • Added Thanos Ruler (Thanos v0.18.0) for the new alerting function.
  • Upgraded Prometheus to v2.26.0.
  • Upgraded Prometheus Operator to v0.42.1.
  • Upgraded kube-state-metrics to v1.9.7.
  • Upgraded metrics-server to v0.4.2.
  • Upgraded Notification Manager to v1.0.0. (Releases)
  • Upgraded FluentBit Operator to v0.5.0. (Releases)
  • Upgraded FluentBit to v1.6.9.
  • Upgraded KubeEvents to v0.2.0.
  • Upgraded Kube-Auditing to v0.1.2.


  • Support configurations of ServiceMonitors on the KubeSphere console. (#1031)
  • Support PromQL auto-completion and syntax highlighting. (#1307)
  • Support customized monitoring at the cluster level. (#3193)
  • Changed the HTTP ports of kube-scheduler and kube-controller-manager from 10251 and 10252 to the HTTPS ports of 10259 and 10257 respectively for data scraping. (#1367)


  • Prometheus-style alerting rules can be managed and configured now. (#3181)
  • Support alerting rules at the platform level and project level. (#3181)
  • Support real-time display of alerting rule status. (#3181)

Notification management

  • Added new notification channels on the console including DingTalk, WeCom, Slack and Webhook to receive notifications. (#3066)


  • Logs can be exported to Loki now. (#39)
  • Support kubelet, Docker, and containerd log collection. (#38)
  • Support auditd log collection. (#45)


  • Improved the error message of pipeline cron text. (#2919)
  • Improved the interactive experience of creating pipelines. (#1283)
  • Improved S2I error messages. (#140)
  • Upgraded Jenkins to 2.249.1. (#2618)
  • Added an approval mechanism for pipelines. Accounts with necessary permissions can review pipelines and approve them. (#2483 and #3006)
  • Multiple pipelines can be started and run at the same time. (#1811)
  • The pipeline status can be viewed on the DevOps project Pipelines page. (#3007)
  • Pipelines can be triggered by tags now. (#3051)
  • Support pipeline cloning. (#3053)
  • Support GitLab multi-branch pipelines. (#3100)
  • Support S2I Webhook. (#6)
  • Jenkins in KubeSphere is now deployed as a distribution (#2182).

App Store and apps

  • The reason for app template deployment failure is now available for check. (#3036, #3001 and #2951)
  • Support batch deleting of app templates.
  • Support editing of deployed app templates.
  • A new built-in app XenonDB is now available in the App Store. Based on MySQL, it is an open-source tool that provides high availability cluster solutions.

Microservices governance

  • The KubeSphere console now displays the traffic direction of microservices in composing apps. (#3153)
  • Support Kiali. Users can now manage Istio directly through Kiali. (#3106)
  • Support NGINX Ingress Gateway monitoring with NGINX Ingress Controller metrics added. (#1205)
  • A route can be added now when an app is created. (#1426)
  • Upgraded Istio to 1.6.10. (#3326)

Metering and billing

  • Users now can see resource consumption of different resources at different levels, such as clusters, workspaces, and apps. (#3062)
  • The resource price can be set in a ConfigMap to provide billing information of resources on the console.

KubeSphere console UI

  • Improved homepage loading.
  • Improved pipeline configurations on graphical editing panels.
  • Improved error messages of pipeline status.
  • Improved the way code repositories are filtered.
  • Improved the configuration of node scheduling policies.
  • Improved deployment configurations.
  • Relocated the built-in web kubectl to a separate page.

Major Technical Adjustments

  • Upgraded Kubernetes version dependencies from v1.17 to v1.18. (#3274)
  • Upgraded the Prometheus client_golang version dependency to v1.5.1 and Prometheus version dependency to v1.8.2. (#3097)
  • Refactored OpenPitrix based on CRDs and fixed some issues caused by the original architecture. (#3036, #3001, #2995, #2981, #2954, #2951, #2783, #2713, #2700 and #1903)
  • Refactored the previous alerting system with old alerting rules deprecated and removed its dependency on MySQL, Redis, etcd and other components. The new alerting system works based on Thanos Ruler and the build-in rules of Prometheus. Old alerting rules in KubeSphere v3.0.0 will be automatically changed to new alerting rules in KubeSphere v3.1.0 after upgrading.
  • Refactored the notification system and removed its dependency on MySQL, Redis, etcd and other components. Notification channels are now configured for the entire cluster based on Notification Manager in CRDs. In a multi-cluster architecture, if a notification channel is set for the Host cluster, it works for all Member Clusters.

Deprecated or Removed Features

  • The legacy alerting and notification system dependent on MySQL, Redis, etcd and other components is replaced by the new alerting and notification function.
  • Changed the container terminal WebSocket API. (#3041)

Bug Fixes

  • Fixed account login failures. (#3132 and #3357)
  • Fixed an issue where ANSI colors were not supported in container logs. (#1322)
  • Fixed an issue where the Istio-related monitoring data of a microservices-based app could not be scraped if its project name started with kube. (#3126)
  • Fixed an issue where viewers at different levels could use the container terminal. (#3041)
  • Fixed a deletion failure issue of cascade resources in a multi-cluster architecture. (#2912)
  • Fixed the incompatibility issue with Kubernetes 1.19 and above. (#2928 and #2928)
  • Fixed the invalid button to view Service monitoring data. (#1394)
  • Fixed an issue where the grayscale release Service name could not be the same as the app label. (#3128)
  • Fixed an issue where the status of microservices-based app could not be updated. (#3241)
  • Fixed an issue where a workspace in a Member Cluster would be deleted if its name was the same as a workspace in the Host Cluster. (#3169)
  • Fixed the connection failure between clusters if agent connection is used. (#3202)
  • Fixed a multi-cluster status display issue. (#3135)
  • Fixed the workload deployment failure in DevOps pipelines. (#3112)
  • Fixed an issue where the account with the admin role in a DevOps project could not download artifacts. (#3088)
  • Fixed an issue of DevOps pipeline creation failure. (#3105)
  • Fixed an issue of triggering pipelines in a multi-cluster architecture. (#2626)
  • Fixed an issue of data loss when a pipeline was edited. (#1270)
  • Fixed a display issue of Docker Container Register Credentials. (#1269)
  • Fixed a localization issue of Chinese unit in the code analysis result. (#1278)
  • Fixed a display issue caused by Boolean values in Jenkinsfiles. (#3043)
  • Fixed a display issue on the Storage Management page caused by the lack of StorageClassName in a PVC. (#1109)

Receive the latest news, articles and updates from KubeSphere

Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.