Upgrading Tanzu Kubernetes Grid Integrated Edition (Flannel Networking)

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic explains how to upgrade VMware Tanzu Kubernetes Grid Integrated Edition from v1.7 to v1.8 on vSphere with Flannel networking, Google Cloud Platform (GCP), Amazon Web Services (AWS), and Azure.

For instructions on upgrading Tanzu Kubernetes Grid Integrated Edition on vSphere with NSX-T networking, see Upgrading Tanzu Kubernetes Grid Integrated Edition (NSX-T Networking).

Warning: Do not manually upgrade your Kubernetes version. Tanzu Kubernetes Grid Integrated Edition includes the compatible Kubernetes version.

Overview

Before you upgrade, follow the procedures in Prepare to Upgrade below to plan and prepare your upgrade.

After you complete the preparation steps, continue to the procedures in Perform the Upgrade below. These steps guide you through the process of upgrading Ops Manager and the Tanzu Kubernetes Grid Integrated Edition tile, importing an updated stemcell, and applying the changes to your deployment.

After you complete the upgrade, follow the procedures in After the Upgrade below to verify that your upgraded Tanzu Kubernetes Grid Integrated Edition deployment is running properly.

Prepare to Upgrade

If you have not already, complete all of the steps in Upgrade Preparation Checklist for Tanzu Kubernetes Grid Integrated Edition v1.8.

Perform the Upgrade

This section describes the steps required to upgrade to Tanzu Kubernetes Grid Integrated Edition v1.8:

  1. Upgrade Ops Manager
  2. Download and Import Tanzu Kubernetes Grid Integrated Edition v1.8
  3. Download and Import Stemcells
  4. Verify Errand Configuration
  5. Verify Other Configurations
  6. Apply Changes to the Tanzu Kubernetes Grid Integrated Edition Tile

Upgrade Ops Manager

Each version of Tanzu Kubernetes Grid Integrated Edition is compatible with multiple versions of Ops Manager. To determine Ops Manager compatibility and, if necessary, upgrade Ops Manager:

  1. See VMware Tanzu Network to determine if your Ops Manager version is compatible with Tanzu Kubernetes Grid Integrated Edition v1.8.
  2. If your Ops Manager version is not compatible with Tanzu Kubernetes Grid Integrated Edition v1.8, follow the steps below.
  3. Upgrade Ops Manager. For instructions, see Import Installation to Ops Manager v2.9 VM.

  4. Verify that the Tanzu Kubernetes Grid Integrated Edition control plane remains functional by performing the following steps:

    1. Add more workloads and create an additional cluster. For more information, see About Cluster Upgrades in Maintaining Workload Uptime and Creating Clusters.
    2. Monitor the Tanzu Kubernetes Grid Integrated Edition control plane in the Tanzu Kubernetes Grid Integrated Edition tile > Status tab. Review the load and resource usage data for the TKGI API and TKGI Database VMs. If any levels are at capacity, scale up the VMs.

Download and Import Tanzu Kubernetes Grid Integrated Edition v1.8

When you upgrade Tanzu Kubernetes Grid Integrated Edition, your configuration settings typically migrate to the new version automatically. To download and import a Tanzu Kubernetes Grid Integrated Edition version:

  1. Download the desired version of the product from VMware Tanzu Network.

  2. Navigate to the Ops Manager Installation Dashboard and click Import a Product to upload the product file.

  3. Under the Import a Product button, click + next to Tanzu Kubernetes Grid Integrated Edition. This adds the tile to your staging area.

Download and Import Stemcells

Tanzu Kubernetes Grid Integrated Edition requires a Xenial stemcell. A stemcell for Windows 2019 is also required if you intend to create Windows worker-based clusters. For information about Windows stemcells, see Configuring Windows Worker-Based Clusters (Beta).

If Ops Manager does not have the Xenial stemcell required for Tanzu Kubernetes Grid Integrated Edition v1.8, the Tanzu Kubernetes Grid Integrated Edition tile displays the message Missing stemcell. To download and import a new Xenial stemcell, follow the steps below:

  1. On the Tanzu Kubernetes Grid Integrated Edition tile, click the Missing stemcell link.

    Verify stemcell assignment

  2. In the Stemcell Library, locate the Tanzu Kubernetes Grid Integrated Edition tile and note the required stemcell version.

  3. Navigate to the Stemcells (Ubuntu Xenial) page on VMware Tanzu Network and download the required stemcell version for your IaaS.

  4. Return to the Installation Dashboard in Ops Manager and click Stemcell Library.

  5. On the Stemcell Library page, click Import Stemcell and select the stemcell file you downloaded from VMware Tanzu Network.

  6. Select the Tanzu Kubernetes Grid Integrated Edition tile and click Apply Stemcell to Products.

  7. Verify that Ops Manager successfully applied the stemcell. The stemcell version you imported and applied appears in the Staged column for Tanzu Kubernetes Grid Integrated Edition.

  8. Return to the Installation Dashboard.

Verify Errand Configuration

To verify your Errands pane is correctly configured, do the following:

  1. In the Tanzu Kubernetes Grid Integrated Edition tile, click Errands.

  2. Under Post-Deploy Errands:

    • Review the Upgrade all clusters errand:
      • If you want to upgrade the Tanzu Kubernetes Grid Integrated Edition tile and all your existing Kubernetes clusters simultaneously, confirm that Upgrade all clusters errand is set to Default (On). The errand upgrades all clusters. Upgrading Tanzu Kubernetes Grid Integrated Edition-provisioned Kubernetes clusters can temporarily interrupt the service as described in Service Interruptions.
      • If you want to upgrade the Tanzu Kubernetes Grid Integrated Edition tile only and then upgrade your existing Kubernetes clusters separately, disable Upgrade all clusters errand. For more information, see Upgrading Clusters.

        Warning: Disabling the Upgrade all clusters errand causes the TKGI version tagged in your Kubernetes clusters to fall behind the Tanzu Kubernetes Grid Integrated Edition tile version. If you disable the Upgrade all clusters errand when upgrading the Tanzu Kubernetes Grid Integrated Edition tile, you must upgrade all your Kubernetes clusters before the next Tanzu Kubernetes Grid Integrated Edition upgrade.

    • Configure the Run smoke tests errand:
      • Set the Run smoke tests errand to On. The errand uses the Tanzu Kubernetes Grid Integrated Edition Command Line Interface (TKGI CLI) to create a Kubernetes cluster and then delete it. If the creation or deletion fails, the errand fails and the installation of the Tanzu Kubernetes Grid Integrated Edition tile is aborted.
  3. Click Save.

Verify Other Configurations

To confirm your other Tanzu Kubernetes Grid Integrated Edition tile panes are correctly configured, do the following:

  1. Review the Assign AZs and Networks pane.

    Note: When you upgrade Tanzu Kubernetes Grid Integrated Edition, you must place singleton jobs in the AZ you selected when you first installed the Tanzu Kubernetes Grid Integrated Edition tile. You cannot move singleton jobs to another AZ.

  2. Review the other configuration panes.
  3. Make changes where necessary.

    WARNING: Do not change the number of master/etcd nodes for any plan that was used to create currently-running clusters. Tanzu Kubernetes Grid Integrated Edition does not support changing the number of master/etcd nodes for plans with existing clusters.

  4. Click Save on any panes where you make changes.

Apply Changes to the Tanzu Kubernetes Grid Integrated Edition Tile

To complete the upgrade of the Tanzu Kubernetes Grid Integrated Edition tile:

  1. Return to the Installation Dashboard in Ops Manager.

  2. Click Review Pending Changes. For more information about this Ops Manager page, see Reviewing Pending Product Changes.

  3. Click Apply Changes.

  4. (Optional) To monitor the progress of the Upgrade all clusters errand using the BOSH CLI, do the following:

    1. Log in to the BOSH Director by running bosh -e MY-ENVIRONMENT log-in from a VM that can access your Tanzu Kubernetes Grid Integrated Edition deployment. For more information, see Using BOSH Diagnostic Commands in Tanzu Kubernetes Grid Integrated Edition.
    2. Run bosh -e MY-ENVIRONMENT tasks.
    3. Locate the task number for the errand in the # column of the BOSH output.
    4. Run bosh task TASK-NUMBER, replacing TASK-NUMBER with the task number you located in the previous step.

After the Upgrade

After you complete the upgrade to Tanzu Kubernetes Grid Integrated Edition v1.8, complete the following verifications and upgrades:

Update the TKGI and Kubernetes CLIs

Update the TKGI and Kubernetes CLIs on any local machine where you run commands that interact with your upgraded version of Tanzu Kubernetes Grid Integrated Edition.

To update your CLIs, download and re-install the TKGI and Kubernetes CLI distributions that are provided with Tanzu Kubernetes Grid Integrated Edition on VMware Tanzu Network.

For more information about installing the CLIs, see the following topics:

Verify the Upgrade

After you apply changes to the Tanzu Kubernetes Grid Integrated Edition tile and the upgrade is complete, do the following:

  1. Verify that your Kubernetes environment is healthy. To verify the health of your Kubernetes environment, see Verifying Deployment Health.

    For any cluster upgrade that fails, you can use the BOSH ID of the upgrade task for debugging. To retrieve the BOSH task ID, see Retrieve Cluster Upgrade Task ID in Verifying Deployment Health.

  2. Verify that the Tanzu Kubernetes Grid Integrated Edition control plane remains functional by performing the following steps:

    1. Add more workloads and create an additional cluster. For more information, see About Cluster Upgrades in Maintaining Workload Uptime and Creating Clusters.
    2. Monitor the Tanzu Kubernetes Grid Integrated Edition control plane in the Tanzu Kubernetes Grid Integrated Edition tile > Status tab. Review the load and resource usage data for the TKGI API and TKGI Database VMs. If any levels are at capacity, scale up the VMs.


Please send any feedback you have to pks-feedback@pivotal.io.