The tanzu command line interface (CLI) is your local tool for interacting with the suite of VMware Tanzu products. This tool allows you to deploy and manage the life cycles of not only Kubernetes clusters, but also application workloads, continuous integration and continuous deployment (CI/CD) pipelines, various packages, as well as other development workflows that leverage Tanzu technologies running on those Kubernetes clusters.
In this guide, you will learn how to install the Tanzu CLI itself, and develop a basic understanding of how it works. You will explore some of the more common commands used within the tanzu CLI. And finally, you will be given some ideas for next steps, and what you can do with the tanzu CLI in your own environment.
By the end of this guide, you will have the tanzu CLI installed, and be ready to use it to create, manage, and deploy workloads to your own Kubernetes cluster.
These are some assumptions you should be aware of before proceeding with this guide:
v0.10.0.v12.0 “Monterey” line. Commands provided in this guide make these assumptions.tanzu CLI. This guide is meant to be a simple setup to get you started quickly. For more complicated or production setups, refer to the official documentation.A list of things you may need to do before getting started with this guide:
pivnet installed - This guide walks you through setting up your account on the Tanzu Network, as well as installing the pivnet CLI tool.tanzuThe tanzu CLI is hosted on the Tanzu Network. This is where many products in the Tanzu suite are also hosted.
You will need to create the install directory, download the tar file from the Tanzu Network, extract it, and run the install binary. Let’s get started.
Create the install directory.
mkdir ~/tanzu
Download the tanzu CLI package from the Tanzu Network. This download command can be found within the tanzu-cli package of Tanzu Application Platform on the Tanzu Network. You may need to accept a EULA if this is your first time downloading this package. It can also be downloaded directly from the GUI as well.
pivnet download-product-files --product-slug='tanzu-application-platform' --release-version='1.1.0-build.17' --product-file-id=1190780
Extract the tar file into the install directory created in the previous step.
tar -xvf tanzu-framework-darwin-amd64.tar -C ~/tanzu
Change your working directory to the install directory.
cd ~/tanzu
Run the install binary to complete the base installation.
sudo install cli/core/v0.10.0/tanzu-core-darwin_amd64 /usr/local/bin/tanzu
Verify the installation.
tanzu version
Example output:
tanzu version
version: v0.10.0
buildDate: 2021-11-03
sha: fd96bebe
Initialize the tanzu CLI.
tanzu init
Example output:
tanzu init
| initializing ✔ successfully initialized CLI
You now have a basic installation of tanzu. In the next section, you will explore some of the more common functionality used with this tool.
tanzuThis section is not meant to be a CLI reference guide. But if this is your first exposure to the tanzu CLI tool, this section should start to familiarize you with some of the more common functions used.
These functions include managing the tanzu tool itself, listing and describing Kubernetes packages, and of course creating and managing Tanzu Kubernetes clusters.
tanzu CLIFirst things first, you need to make sure you are running the latest and greatest version of the tool. This may not seem intuitive since you just installed it, but check anyway. There can sometimes be updates available before they hit the Tanzu Network.
Update the tanzu CLI.
tanzu update
Example output:
tanzu update
ℹ the following updates will take place:
core v0.10.0 → v0.12.0
? would you like to continue? [y/n]
If there is an update available, go ahead and install it by typing a y.
Example output:
✔ successfully updated CLI
Verify the update process.
tanzu version
Example output:
tanzu version
version: v0.12.0
buildDate: 2021-11-25
sha: ff02d464
Your tanzu installation should now be fully up to date. Repeating this process on occasion will help keep it that way.
While with most CLI tools, the available commands are often thought of as built in, for the Tanzu CLI, these commands are better thought of as plug-ins.
Some of these plug-ins are built in. And for managing certain products, additional plug-ins can be added. This will become more clear in future guides where you will add additional plug-ins.
List the plug-ins currently available to you.
tanzu plugin list
Example output:
tanzu plugin list
NAME DESCRIPTION SCOPE DISCOVERY VERSION STATUS
login Login to the platform Standalone default v0.12.0 installed
management-cluster Kubernetes management-cluster operations Standalone default v0.12.0 installed
package Tanzu package management Standalone default v0.12.0 installed
pinniped-auth Pinniped authentication operations (usually not directly invoked) Standalone default v0.12.0 installed
secret Tanzu secret management Standalone default v0.12.0 installed
Optional: If your plug-ins are listed as not installed, this can sometimes happen after an upgrade, since the plug-ins and the tanzu CLI itself can have different release schedules. If this is the case, you can reinstall and upgrade each plug-in individually here.
tanzu plugin install <package-name>
Optional: If your plug-ins are listed as upgrade available, again this can happen due to the separate release schedules and lifecycle management strategies of plug-ins versus the Tanzu CLI itself. You can upgrade each plug-in individually here.
tanzu plugin upgrade <plugin-name>
There are other useful commands for managing plug-ins as well. Use the --help flag at any time to get a list of available commands and their usage.
Packages are different from plug-ins. While plug-ins function as commands available to the Tanzu CLI, plug-ins are effectively installable applications, usually onto a Kubernetes cluster.
Some packages are included by default. And like plug-ins, more can be added using a repository model. As repositories are added to the Tanzu CLI, additional packages provided from VMware become available to install and use. More on this in future guides.
List packages currently available to you.
tanzu package available list
Example output:
\ Retrieving available packages...
NAME DISPLAY-NAME SHORT-DESCRIPTION LATEST-VERSION
cert-manager.tanzu.vmware.com cert-manager Certificate management 1.5.3+vmware.2-tkg.1-tf-v0.11.0
contour.tanzu.vmware.com contour An ingress controller 1.18.2+vmware.1-tkg.1-tf-v0.11.0
external-dns.tanzu.vmware.com external-dns This package provides DNS synchronization functionality. 0.10.0+vmware.1-tkg.1-tf-v0.11.0
fluent-bit.tanzu.vmware.com fluent-bit Fluent Bit is a fast Log Processor and Forwarder 1.7.5+vmware.1-tkg.2-tf-v0.11.0
grafana.tanzu.vmware.com grafana Visualization and analytics software 7.5.7+vmware.1-tkg.2-tf-v0.11.0
harbor.tanzu.vmware.com harbor OCI Registry 2.3.3+vmware.1-tkg.1-tf-v0.11.0
multus-cni.tanzu.vmware.com multus-cni This package provides the ability for enabling attaching multiple network interfaces to pods in Kubernetes 3.7.1+vmware.2-tkg.2-tf-v0.11.0
prometheus.tanzu.vmware.com prometheus A time series database for your metrics 2.27.0+vmware.1-tkg.2-tf-v0.11.0
Here you can see the package name, the display name, a brief description of each package, and its version.
List repositories currently available to you. Since the only packages available are the ones built in, there won’t be any repositories added yet.
tanzu package repository list
Example output:
\ Retrieving repositories…
NAME REPOSITORY TAG STATUS DETAILS
There are other useful commands for managing packages as well. Use the --help flag at any time to get a list of available commands and their usage.
You haven’t created any clusters yet, so this section won’t be that interesting. That project will come in a later guide series. But starting to look at some of the available commands will help you in the future.
List clusters currently connected to your Tanzu CLI.
tanzu cluster list
Example output:
tanzu cluster list
NAME NAMESPACE STATUS CONTROLPLANE WORKERS KUBERNETES ROLES PLAN
Take a look at how easy it is to create a new Kubernetes cluster using the Tanzu CLI. You will create one in a future guide.
tanzu cluster create --help
There is a lot more to unpack with managing clusters, but since you don’t have one to manage yet, this is all you are going to do as part of this guide.
Future guides will walk you through more of these powerful features for managing the Kubernetes cluster lifecycle.
tanzu CLIAs a CLI tool, the Tanzu CLI is meant to just get out of the way when you aren’t using it. However, there may be scenarios where you want to remove the tool.
Since this tool uses a plug-in architecture, it is a little more involved than simply deleting the binary from your $PATH. Follow these instructions to completely remove the Tanzu CLI from your system.
Before you delete the tool, make sure that any clusters you have created are deleted.
Remove all of the created directories and the Tanzu binary.
sudo rm -rf ~/tanzu/cli ~/.config/tanzu ~/Library/Application\ Support/tanzu-cli/* /usr/local/bin/tanzu ~/.cache/tanzu
From here, you can go back through the install process above and reinstall if needed.
If you have completed the Tanzu Network guide as well as this one, congratulations! You are now ready to really start playing with the power of the Tanzu ecosystem for developers.