Before upgrading, keep in mind there is an inherent risk to upgrading any Kubernetes cluster because any failure or error could result in unexpected downtime or loss of data. You should take whatever precautions are necessary before starting the upgrade process. For example, you should be sure to back up the cluster state and all cluster-related files using velero before you upgrade.
You should also keep in mind that cluster add-ons require a specific minimum version of Kubernetes to be installed.
You can verify the version you have installed before upgrading by running the
kubectl version --short=true command.
cluster.yaml file, a change to the
ClusterConfiguration is necessary such that the
spec.kubernetes.version matches the version information for the cluster you want deployed.
For example, assume the cluster was launched with the following
kind: ClusterConfiguration apiVersion: konvoy.mesosphere.io/v1alpha1 metadata: name: alejandro creationTimestamp: "2019-06-08T03:25:20.939527Z" spec: kubernetes: version: 1.15.2 networking: podSubnet: 192.168.0.0/16 serviceSubnet: 10.0.0.0/18
If you want to upgrade to a newer patch version of
1.15, then you would change the version string like this:
kind: ClusterConfiguration apiVersion: konvoy.mesosphere.io/v1alpha1 metadata: name: alejandro creationTimestamp: "2019-06-08T03:25:20.939527Z" spec: kubernetes: version: 1.15.2
After you modify the version information, you can start the upgrade process by running the following Konvoy command:
konvoy up --upgrade -y This process will take about 20 minutes to complete (additional time may be required for larger clusters) STAGE [Determining Upgrade Safety] ...