Difference Between MajorUpgradeVersion, MinorUpgradeVersion and PatchUpgradeVersion

Problem

• How to identify the MajorUpgradeVersion, MinorUpgradeVersion and PatchUpgradeVersion?
• How to find the latest SupportedRoleVersions?

Environment

• Platform9 Managed Kubernetes - All Versions

Answer

• PatchUpgradeVersion - The Last field or Third filed of the version changes. For example: 1.18.10-pmk.1357 --> 1.18.10-pmk.1547. This is Platform9 Patch Upgrade Version. Another example: 1.20.4 --> 1.20.5. This is Kubernetes Patch Upgrade Version.

• MinorUpgradeVersion - The Second field of the version changes. For example: 1.18.10-pmk.1357 --> 1.19.6-pmk.1701. Here the minor upgrade is because v1.18 --> v1.19

Info

During a Minor version upgrade, it always selects the latest patch version available. For example, The current Kubernetes Version is 1.19.6-pmk.1625 and a minor version upgrade takes to the latest available 1.20 version which is 1.20.5-pmk.1894 ( 1.19.6-pmk.1625 --> 1.20.5-pmk.1894)

• MajorUpgradeVersion - The First field of the version change. For example: v1.20 --> v2.1

Info

Platform Managed Kubernetes(PMK) has Multi-Version Support from v5.0 so can select either patch or minor upgrade based on requirement or preference.

• All the supported version can also be found using the following Qbert API call:

Example

# curl -s https://<DU_FQDN>/qbert/v4/<project_ID>/clusters/supportedRoleVersions -H "X-Auth-Token: $OS_TOKEN" | jq | grep roleVersion
      "roleVersion": "1.17.9-pmk.1467",
      "roleVersion": "1.18.10-pmk.1547",
      "roleVersion": "1.19.6-pmk.1625",
      "roleVersion": "1.20.5-pmk.1865",

Info

The token can be generated by following steps mentioned in Keystone Identity.