Install multicluster Tanzu Application Platform profiles

This topic tells you how to install a multicluster topology for your Tanzu Application Platform (commonly known as TAP).

Prerequisites

Before installing multicluster Tanzu Application Platform profiles, you must meet the following prerequisites:

All clusters must satisfy all the requirements to install Tanzu Application Platform. See the Tanzu Application Platform Prerequisites.
Install the Tanzu CLI with any required plug-ins.
Install Cluster Essentials on all clusters.

Multicluster Installation Order of Operations

The installation order is flexible given the ability to update the installation with a modified values file using the tanzu package installed update command. The following is an example of the order of operations to be used:

Install View profile cluster.
Install Build profile cluster.
Install Run profile cluster.
Install Iterate profile cluster.
Add Build, Run and Iterate clusters to Tanzu Developer Portal.
Update the View cluster’s installation values file with the previous information and run the following command to pass the updated config values to Tanzu Developer Portal:
```
tanzu package installed update tap -p tap.tanzu.vmware.com -v TAP-VERSION --values-file tap-values.yaml -n tap-install
```
Where TAP-VERSION is the Tanzu Application Platform version you’ve installed.

Install View cluster

Install the View profile cluster first, because some components must exist before installing the Run clusters. For example, the Application Live View back end must be present before installing the Run clusters. For more information about profiles, see About Tanzu Application Platform package profiles.

To install the View cluster:

Follow the steps described in Installing the Tanzu Application Platform package and profiles by using a reduced values file as shown in View profile.
Verify that you can access Tanzu Developer Portal by using the ingress that you set up. The address must follow this format: https://tap-gui.INGRESS-DOMAIN, where INGRESS-DOMAIN is the DNS domain you set in shared.ingress_domain which points to the shared Contour installation in the tanzu-system-ingress namespace with the service envoy.
Follow the steps in setting up multicluster Artifact Metadata Repository (AMR).

Install Build clusters

To install the Build profile cluster, follow the steps described in Installing the Tanzu Application Platform package and profiles by using a reduced values file as shown in Build profile.

Install Run clusters

To install the Run profile cluster:

Follow the steps described in Install the Tanzu Application Platform package and profiles by using a reduced values file as shown in Run profile.
To use Application Live View, set the INGRESS-DOMAIN for appliveview_connector to match the value you set on the View profile for the appliveview in the values file.

Note
The default configuration of shared.ingress_domain points to the local Run cluster, rather than the View cluster, as a result, shared.ingress_domain must be set explicitly.

Install Iterate clusters

To install the Iterate profile cluster, follow the steps described in Install the Tanzu Application Platform package and profiles by using a reduced values file as shown in Iterate profile.

Add Build, Run and Iterate clusters to Tanzu Developer Portal

After installing the Build, Run and Iterate clusters, follow the steps in View resources on multiple clusters in Tanzu Developer Portal to:

Create the Service Accounts that Tanzu Developer Portal uses to read objects from the clusters.
Add a remote cluster.

These steps create the necessary RBAC elements allowing you to pull the URL and token from the Build, Run and Iterate clusters that allows them come back and add to the View cluster’s values file.

You must add the Build, Run and Iterate clusters to the View cluster for all plug-ins to function as expected.

Next steps

After setting up the four profiles, you’re ready to run a workload by using the supply chain. See Get started with multicluster Tanzu Application Platform.