Upgrade Application Service Adapter

This topic gives you the steps to upgrade Application Service Adapter for VMware Tanzu Application Platform.

You can perform a fresh installation of Application Service Adapter by following the instructions in Install Application Service Adapter.

When upgrading to a new major or minor version of Application Service Adapter, see the documentation for that version for version-specific configuration and upgrade instructions.

You can find new patch versions of Application Service Adapter on the TanzuNet product page directly, or sign up to receive email alerts when the product is updated.

Note

Upgrades are not currently supported if you have enabled the experimental Cartographer integration. Existing application workloads do not behave correctly after upgrading from v1.0 to v1.1.

Prerequisites

Before you upgrade Application Service Adapter:

• Verify that you meet all the prerequisites of the target Tanzu Application Service Adapter version. If the target Tanzu Application version does not support your existing Kubernetes version, VMware recommends upgrading to a supported version before proceeding with the upgrade.
• Back up important cluster state, Kubernetes etcd and the container registries used for storing app images, as described in the Disaster Recovery topic.
• Install or update the Tanzu CLI and plug-ins
  • For information about installing or updating the Tanzu CLI and plug-ins, see Install or update the Tanzu CLI and plug-ins.
• Verify that all packages are reconciled by running tanzu package installed list -A.
• VMware recommends upgrading the Tanzu Application Platform version to the latest patch version of the currently installed major-minor (for example, 1.3).

Update the new package repository

Follow these steps to update the new package repository:

1. Add the target version of the Application Service Adapter package repository:

   tanzu package repository add tas-adapter-repository \
     --url registry.tanzu.vmware.com/app-service-adapter/tas-adapter-package-repo:${TAS_ADAPTER_VERSION} \
     --namespace tap-install
   

   Where TAS_ADAPTER_VERSION is the target revision of Application Service Adapter you are migrating to.

2. Verify you have added the new package repository by running:

   tanzu package available list \
     --namespace tap-install
   

Upgrading to v1.3

1. The tas-adapter-values.yaml file for v1.3 is compatible with the one used for v1.2.

Note

Performing the update causes downtime for any single-instance apps. To avoid downtime, scale the apps to 2 or more instances. If you have the experimental Choreographer integration enabled, all apps will have downtime regardless of their instance counts.

Perform the upgrade of Application Service Adapter

To upgrade, run:

tanzu package installed update tas-adapter \
  -p application-service-adapter.tanzu.vmware.com \
  --version "${TAS_ADAPTER_VERSION}" \
  --values-file tas-adapter-values.yaml \
  --namespace tap-install

Where TAS_ADAPTER_VERSION is the target revision of Application Service Adapter you are migrating to.

Verify the upgrade

Important

Run the following command in the directory where the tas-adapter-values.yaml file resides.

To verify the versions of packages after the upgrade, run:

tanzu package installed list --namespace tap-install

Your output should be similar, but probably not identical, to the following example output:

  Retrieving installed packages...
  NAME                        PACKAGE-NAME                                 PACKAGE-VERSION  STATUS
  api-auto-registration       apis.apps.tanzu.vmware.com                   0.1.1            Reconcile succeeded
  appsso                      sso.apps.tanzu.vmware.com                    2.0.0            Reconcile succeeded
  buildservice                buildservice.tanzu.vmware.com                1.7.2            Reconcile succeeded
  cartographer                cartographer.tanzu.vmware.com                0.5.3            Reconcile succeeded
  cert-manager                cert-manager.tanzu.vmware.com                1.7.2+tap.1      Reconcile succeeded
  contour                     contour.tanzu.vmware.com                     1.22.0+tap.4     Reconcile succeeded
  eventing                    eventing.tanzu.vmware.com                    2.0.1            Reconcile succeeded
  ootb-templates              ootb-templates.tanzu.vmware.com              0.10.2           Reconcile succeeded
  policy-controller           policy.apps.tanzu.vmware.com                 1.1.2            Reconcile succeeded
  service-bindings            service-bindings.labs.vmware.com             0.8.0            Reconcile succeeded
  source-controller           controller.source.apps.tanzu.vmware.com      0.5.0            Reconcile succeeded
  tap                         tap.tanzu.vmware.com                         1.3.0            Reconcile succeeded
  tap-telemetry               tap-telemetry.tanzu.vmware.com               0.3.1            Reconcile succeeded
  application-service-adapter application-service-adapter.tanzu.vmware.com 1.0.1            Reconcile succeeded
  tekton-pipelines            tekton.tanzu.vmware.com                      0.39.0+tap.2     Reconcile succeeded