Upgrade — Overview

Make Your Upgrade Plan

KubeSphere v3.1.1 is compatible with Kubernetes 1.17.x, 1.18.x, 1.19.x and 1.20.x:

  • Before you upgrade your cluster to KubeSphere v3.1.1, you need to have a KubeSphere cluster running v3.0.0.
  • If your existing KubeSphere v3.0.0 cluster is installed on Kubernetes 1.17.x+, you can choose to only upgrade KubeSphere to v3.1.1 or upgrade Kubernetes (to a higher version) and KubeSphere (to v3.1.1) at the same time.
  • If your existing KubeSphere v3.0.0 cluster is installed on Kubernetes 1.16.x or earlier, you have to upgrade Kubernetes (to 1.17.x+) and KubeSphere (to v3.1.1) at the same time.

Before the Upgrade

Warning

  • You are supposed to implement a simulation for the upgrade in a testing environment first. After the upgrade is successful in the testing environment and all applications are running normally, upgrade your cluster in your production environment.
  • During the upgrade process, there may be a short interruption of applications (especially for those single-replica Pods). Please arrange a reasonable period of time for your upgrade.
  • It is recommended to back up etcd and stateful applications before in production. You can use Velero to implement the backup and migrate Kubernetes resources and persistent volumes.

Upgrade Tool

Depending on how your existing cluster was set up, you can use KubeKey or ks-installer to upgrade your cluster. It is recommended that you use KubeKey to upgrade your cluster if it was created by KubeKey. Otherwise, use ks-installer to upgrade your cluster.


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.