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.29.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.29.0 or later on Tanzu Community Edition v0.9.1:

  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
    

    Note: If you are using Tanzu Community Edition v0.9.1 standalone cluster, skip the following 3 steps. Go directly to step 6 to delete the current kapp-controller.

  3. Prevent the Management cluster from reconciling the kapp-controller in the workload cluster by running:

    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:

    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:

    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.29.0 by running:

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

Install the Tanzu CLI Plugins for Tanzu Application Platform

Follow the Instructions for Updating Tanzu CLI previously installed for Tanzu Kubernetes Grid and Tanzu Community Edition.

After you've completed the update, you can proceed to the "Install Tanzu Application Platform" section below.

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 the Tanzu Application Platform documentation to meet all the prerequisites.

  2. Follow the steps in Installing Part II: Profiles 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