This topic lists prerequisites and instructions for installing Tanzu Application Platform on a Tanzu Community Edition v0.9.1 cluster.

Warning: VMware discourages installing Tanzu Application Platform on a Tanzu Community Edition v0.9.1 cluster in production environments. This procedure includes a workaround for installing kapp-controller v0.27.0 on Tanzu Community Edition v0.9.1 however, this is not a supported workflow. VMware recommends that you follow this procedure for beta environments only.

Install Tanzu Community Edition v0.9.1

To install on Tanzu Community Edition v0.9.1, follow the instructions in these two sections:

Install kapp-controller

To install kapp-controller v0.27.0 or later on Tanzu Community Edition v0.9.1, do the following:

  1. Create a new workload or cluster. Do not install any packages on the cluster.
  2. Set the kubectl context to the Tanzu Community Edition Management cluster or Tanzu Community Edition Standalone cluster by running:

    kubectl config get-contexts
    CURRENT   NAME                          CLUSTER            AUTHINFO           NAMESPACE
    *         az-standalone-tce-admin@az-standalone-tce              az-standalone-tce                                      az-standalone-tce-admin   
          az-tanzu-ce-workload-admin@az-tanzu-ce-workload        az-tanzu-ce-workload                                   az-tanzu-ce-workload-admin
    
  3. Prevent the Management cluster from reconciling the kapp-controller in the workload cluster by running:

    Note: Skip this step if you are using a Tanzu Community Edition v0.9.1 standalone cluster.

    kubectl patch app/<WORKLOAD-CLUSTER>-kapp-controller -n default -p '{"spec":{"paused":true}}' --type=merge
    

    Where <WORKLOAD-CLUSTER> is the name of the cluster you created earlier.

  4. Import the kubeconfig for the workload cluster by running:

    Note: Skip this step if you're using Tanzu Community Edition v0.9.1 standalone cluster.

    tanzu cluster kubeconfig get <WORKLOAD-CLUSTER> --admin
    

    Where <WORKLOAD-CLUSTER> is the name of the cluster you created earlier.

  5. Switch the kubectl context to the workload cluster by running:

    Note: Skip this step if you're using Tanzu Community Edition v0.9.1 standalone cluster.

    kubectl config use-context <WORKLOAD-CLUSTER-CONTEXT>
    

    Where <WORKLOAD-CLUSTER-CONTEXT> is the kubeconfig context you imported earlier.

  6. Delete the current kapp-controller by running:

    kubectl delete deployment kapp-controller -n tkg-system
    
  7. Install kapp-controller v0.27.0 by running:

    kubectl apply -f https://github.com/vmware-tanzu/carvel-kapp-controller/releases/download/v0.27.0/release.yml
    

Install the Tanzu CLI Plugins for Tanzu Application Platform

To install the Tanzu CLI plugins required for Tanzu Application Platform:

  1. Create a directory named tanzu-framework by running:

    mkdir $HOME/tanzu-framework
    
  2. Sign in to Tanzu Network.

  3. Navigate to Tanzu Application Platform on Tanzu Network.

  4. Click the tanzu-cli-0.5.0 directory.

  5. Download the CLI bundle corresponding with your operating system. For example, if your client operating system is Linux, download the tanzu-framework-linux-amd64.tar bundle.

  6. Unpack the TAR file in the tanzu-framework directory by running:

    tar -xvf tanzu-framework-linux-amd64.tar -C $HOME/tanzu-framework
    
  7. Navigate to the tanzu-framework directory by running:

    cd $HOME/tanzu-framework
    
  8. Install the imagepullsecret plugin by running:

    tanzu plugin install imagepullsecret --local ./cli
    
  9. Install the accelerator plugin by running:

    tanzu plugin install accelerator --local ./cli
    
  10. Install the apps plugin by running:

    tanzu plugin install apps --local ./cli
    

Install Tanzu Application Platform

  1. Ensure you meet all the prerequisites to install Tanzu Application Platform. See Prerequisites in Installing Part I: Prerequisites, EULA, and CLI.

    Note: Do not attempt to install the cert-manager package from Tanzu Standard Repository. Follow the instructions in TAP documentation to meet all the prerequisites.

  2. Follow the steps in Installing Part II: Packages to install Tanzu Application Platform on a Tanzu Community Edition v0.9.1 cluster.
check-circle-line exclamation-circle-line close-line
Scroll to top icon