Skip to content

Latest commit

 

History

History
87 lines (58 loc) · 4.07 KB

install-tce.md

File metadata and controls

87 lines (58 loc) · 4.07 KB
Raw

Installing on a Tanzu Community Edition v0.9.1 Cluster

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, 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.

```console
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.
  1. 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.

```console
tanzu cluster kubeconfig get <WORKLOAD-CLUSTER> --admin
```
Where `<WORKLOAD-CLUSTER>` is the name of the cluster you created earlier.
  1. 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.

```console
kubectl config use-context <WORKLOAD-CLUSTER-CONTEXT>
```
Where `<WORKLOAD-CLUSTER-CONTEXT>` is the kubeconfig context you imported earlier.

  1. Delete the current kapp-controller by running:

    kubectl delete deployment kapp-controller -n tkg-system

  2. 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 which was originally installed for Tanzu Kubernetes Grid and Tanzu Community Edition.

Once completed, you may 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.