Skip to content

Latest commit

 

History

History
93 lines (63 loc) · 3.71 KB

install-tkg.md

File metadata and controls

93 lines (63 loc) · 3.71 KB
Raw

Installing on a Tanzu Kubernetes Grid v1.4 cluster

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

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

  8. Install secretgen-controller v0.7.1 or greater by running:

    kubectl create ns secretgen-controller
kubectl apply -f https://github.com/vmware-tanzu/carvel-secretgen-controller/releases/latest/download/release.yml

Install the Tanzu CLI and plugins for Tanzu Application Platform

Follow the instructions for updating Tanzu CLI that was originally installed for Tanzu Kubernetes Grid and Tanzu Community Edition.

Once completed, you may proceed to the next section.

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 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 Kubernetes Grid v1.4 cluster.