This topic lists prerequisites and instructions for installing Tanzu Application Platform on a Tanzu Kubernetes Grid v1.4 cluster.

Warning: VMware discourages installing Tanzu Application Platform on a Tanzu Kubernetes Grid v1.4 cluster in production environments. This procedure includes a workaround for installing kapp-controller v0.27.0 on Tanzu Kubernetes Grid v1.4, which is not a supported workflow. VMware recommends that you follow this procedure for beta purposes only.

Install Tanzu Kubernetes Grid v1.4

To install Tanzu Kubernetes Grid v1.4, you must:

Install kapp-controller

To install kapp-controller v0.27.0 or later on Tanzu Kubernetes Grid v1.4:

  1. Create a new workload cluster. Do not install any packages in the cluster.
  2. Ensure the kubectl context is set to the Tanzu Kubernetes Grid Management cluster by running:

    kubectl config get-contexts
    CURRENT   NAME                          CLUSTER            AUTHINFO           NAMESPACE
        kind-dev-cluster              kind-dev-cluster   kind-dev-cluster
    *         tkg4tap-admin@tkg4tap         tkg4tap            tkg4tap-admin
        tkg4tapwld-admin@tkg4tapwld   tkg4tapwld         tkg4tapwld-admin
    
  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 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 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 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 VMware Tanzu Network.

  4. Click on the tanzu-cli-0.5.0 directory.

  5. Download the CLI bundle corresponding to 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 Kubernetes Grid v1.4 cluster.
check-circle-line exclamation-circle-line close-line
Scroll to top icon