Prerequisites

You must have uploaded virtual machine template of the specific k8s version to VMware Telco Cloud Automation that the upgraded cluster will run. Refer to Import New BYOI Templates into vSphere.

Procedure

  1. Log in to the VMware Telco Cloud Automation web interface.
  2. Under Infrastructure, select CaaS Infrastructure from the left pane. The CaaS Infrastructure page is displayed.
  3. Select the cluster instance for upgrade.
  4. Click the Options (⋮) symbol against the Kubernetes cluster that you want to upgrade.
  5. (Best Practice) Run diagnosis with type Upgrade Diagnosis, choose Pre-upgrade type. For more information, see Running Cluster Diagnosis.
  6. Select Upgrade Cluster. The Upgrade Cluster wizard is displayed.
  7. Navigate to the Get Started tab.
    1. In the Upgrade Name, the default value will be provided in the format upgrade-[cluster name]-[current time] and is editable.
    2. (Optional) In the Description field, input the description of this upgrade.
    3. In the I want to upgrade field, select Control Plane + Node Pools or Only Control Plane and Only Node Pools.
      Note: Only Node Pools can only be selected after upgrading the control plane.
    4. In the Select TCA Bom Release, select the tbr bom release applicable for the new version of Kubernetes.
  8. Click Next.
  9. Navigate to the Select Target Virtual Machine Template tab under Control Plane.

    In Virtual Machine Template, select the VM template applicable for the new version of Kubernetes.

  10. Click Next.
  11. Navigate to the Select Node Pool(s) to upgrade tab under Node Pools and customize the VM templte and Upgrade Strategy.
    Note: This step is only applicable while upgrading a Control Plane + Node Pools.
    1. Choose among the 2 listed options to assign the VM template:
      1. Select a specific node pool and choose the VM template for this node pool.
      2. Select multiple node pools and click Assign New VM Template, choose the VM template for all selected node pools.
    2. Choose among the 2 listed options to assign upgrade strategy:
      1. Select a specific node pool and specify the upgrade strategy. Once selected, you can navigate to more under New Upgrade Strategy to check the configuration details.
        Note: Details under more will be in read-only mode. To edit, select the node pool again and click Advanced Options.
      2. Select multiple node pools, click Advanced Options.
    Note: The nodepool will be included in upgrade once the VM Template is selected. To exclude one nodepool from the upgrade list, click Include for Upgrade manually.
  12. Click Next.
  13. Review the upgrade configurations and click Upgrade.

    1. (Optional) Choose among the 2 listed options:
      • Navigate to Infrastructure > CaaS Infrastructure > Upgrade.
      • Navigate to Infrastructure > CaaS Infrastructure > Cluster Instances. Select the cluster you want to monitor the upgrade progress, and navigate to the Upgrade tab of the cluster.
    2. The upgrade status will be:
      • Upgraded: Upgrade process is successful.
      • Upgrading: Upgrade process is in progress.
      • Failed: Upgrade process failed.
    3. Click > corresponding to the specific upgrade, view the upgrade progress.

    4. To get further information, please check relative resource condition and events.

Results

  1. Log in to the VMware Telco Cloud Automation web interface.
  2. Navigate to Infrastructure > CaaS Infrastructure > Cluster Instances.
  3. Select the cluster you upgraded, confirm that the cluster kubernetes version is upgraded.