This topic tells you how to accept the EULAs, and install the Tanzu CLI and plug-ins on Tanzu Application Platform (commonly known as TAP).
Before downloading and installing Tanzu Application Platform packages, you must accept the End User License Agreements (EULAs) as follows:
Sign in to VMware Tanzu Network.
Accept or confirm that you have accepted the EULAs for each of the following:
To accept the Tanzu Application Platform EULA:
Go to Tanzu Application Platform.
Select the Click here to sign the EULA link in the yellow warning box under the release drop-down menu. If the yellow warning box is not visible, the EULA has already been accepted.
Select Agree in the bottom-right of the dialog box as seen in the following screenshot.
For information about the supported Kubernetes cluster providers and versions, see Kubernetes cluster requirements.
To set the Kubernetes cluster context:
List the existing contexts by running:
kubectl config get-contexts
$ kubectl config get-contexts CURRENT NAME CLUSTER AUTHINFO NAMESPACE aks-repo-trial aks-repo-trial clusterUser_aks-rg-01_aks-repo-trial * aks-tap-cluster aks-tap-cluster clusterUser_aks-rg-01_aks-tap-cluster
If you are managing multiple cluster contexts, set the context to the cluster that you want to use for the Tanzu Application Platform packages installation by running:
kubectl config use-context CONTEXT
CONTEXT is the cluster that you want to use. For example,
$ kubectl config use-context aks-tap-cluster Switched to context "aks-tap-cluster".
The Tanzu CLI and plug-ins enable you to install and use the Tanzu Application Platform functions and features.
The Tanzu CLI core v1.0.0 distributed with Tanzu Application Platform is forward and backward compatible with all supported releases of Tanzu Application Platform.
Run a single command to install the plug-in group version that matches the Tanzu Application Platform version on any target environment. For more information, see Install Tanzu CLI Plug-ins.
Use a package manager to install Tanzu CLI on Windows, Mac, or Linux OS. Alternatively, download and install manually from Tanzu Network, VMware Customer Connect, or GitHub.
Basic installation instructions are provided below. For more information including how to install the Tanzu CLI and CLI plug-ins in Internet-restricted environments, see the VMware Tanzu CLI documentation.
To retain an existing installation of the Tanzu CLI, move the CLI binary from
C:\Program Files\tanzuon Windows to a different location before following the steps below.
Follow the instructions for your package manager below. This installs the latest version of the CLI available in the package registry.
brew update brew install vmware-tanzu/tanzu/tanzu-cli
choco install tanzu-cli
tanzu-cli package is part of the main Chocolatey Community Repository. When a new
tanzu-cli version is released, it might not be available immediately. If the above command fails, run:
choco install tanzu-cli --version TANZU-CLI-VERSION
TANZU-CLI-VERSION is the Tanzu CLI version you want to install.
choco install tanzu-cli --version 1.0.0
APT (Debian or Ubuntu):
sudo mkdir -p /etc/apt/keyrings/ sudo apt-get update sudo apt-get install -y ca-certificates curl gpg curl -fsSL https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub | sudo gpg --dearmor -o /etc/apt/keyrings/tanzu-archive-keyring.gpg echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/tanzu-archive-keyring.gpg] https://storage.googleapis.com/tanzu-cli-os-packages/apt tanzu-cli-jessie main" | sudo tee /etc/apt/sources.list.d/tanzu.list sudo apt-get update sudo apt-get install -y tanzu-cli
YUM or DNF (RHEL):
cat << EOF | sudo tee /etc/yum.repos.d/tanzu-cli.repo [tanzu-cli] name=Tanzu CLI baseurl=https://storage.googleapis.com/tanzu-cli-os-packages/rpm/tanzu-cli enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.vmware.com/tools/keys/VMWARE-PACKAGING-GPG-RSA-KEY.pub EOF sudo yum install -y tanzu-cli # If you are using DNF, run sudo dnf install -y tanzu-cli.
Check that the correct version of the CLI is properly installed.
tanzu version version: v1.0.0 ...
Download the Tanzu CLI binary from one of the following locations:
VMware Tanzu Network
VMware Customer Connect
Use an extraction tool to unpack the binary file:
tar -xvf tanzu-cli-darwin-amd64.tar.gz
tar -xvf tanzu-cli-linux-amd64.tar.gz
Use the Windows extractor tool to unzip
Make the CLI available to the system:
cd to the directory containing the extracted CLI binary
Install the binary to
install tanzu-cli-darwin_amd64 /usr/local/bin/tanzu
Install the binary to
sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
tanzu-cli-windows_amd64.exefile into the new
tanzufolder, select Properties > Security, and make sure that your user account has the Full Control permission.
Pathrow under System variables, and click Edit.
.exeextension. For example,
Check that the correct version of the CLI is properly installed:
tanzu version version: v1.0.0 ...
There is a group of Tanzu CLI plug-ins which extend the Tanzu CLI Core with Tanzu Application Platform specific functionality. The plug-ins can be installed as a group with a single command.
Versioned releases of the Tanzu Application Platform specific plug-in group align to each supported Tanzu Application Platform version.
This makes it easy to switch between different versions of Tanzu Application Platforms environments. Use the following commands to search for, install, and verify Tanzu CLI plug-in groups.
tanzu plugin group search --show-details
tanzu plugin group search --name vmware-tanzu/default --show-details
tanzu plugin install --group vmware-tap/default:v1.5.5
tanzu plugin group get vmware-tap/default:v1.5.5
tanzu plugin list
For air-gapped installation, see the Installing the Tanzu CLI in Internet-Restricted Environments section of the Tanzu CLI documentation.
For online installation:
For air-gapped installation:
For GitOps (beta) installation:
* When you use a VMware Tanzu Kubernetes Grid cluster, you do not need to install Cluster Essentials because the contents of Cluster Essentials are already installed on your cluster.