check-circle-line exclamation-circle-line close-line

<

The Tanzu Kubernetes Grid bundle includes the Tanzu Kubernetes Grid CLI binaries and cluster plans from which Tanzu Kubernetes Grid deploys clusters. Tanzu Kubernetes Grid also provides the base OS images from which node VMs are created, that include the supported versions of Kubernetes and Cluster API.

To use Tanzu Kubernetes Grid, you download and run the Tanzu Kubernetes Grid CLI on a local system, known as the bootstrap environment. The bootstrap environment is the laptop, host, or server on which the initial bootstrapping of a management cluster is performed. This is where you run Tanzu Kubernetes Grid CLI commands. Tanzu Kubernetes Grid creates a temporary management cluster using a Kubernetes in Docker (kind) cluster on the bootstrap environment. After creating the temporary management cluster locally, Tanzu Kubernetes Grid uses it to provision the final management cluster in the platform of your choice.

Prerequisites

Tanzu Kubernetes Grid provides CLI binaries for Linux and Mac OS systems.

The bootstrap environment on which you run the Tanzu Kubernetes Grid CLI must meet the following requirements:

  • If you intend to use the Tanzu Kubernetes Grid installer interface, a browser is available. You can use the Tanzu Kubernetes Grid CLI without a browser, but for first deployments it is strongly recommended to use the installer interface.
  • kubectl is installed.
  • Docker is installed and running, if you are installing Tanzu Kubernetes Grid on Linux platforms.
  • Docker Desktop is installed and running, if you are installing Tanzu Kubernetes Grid on Mac OS platforms.
  • System time is synchronized with a Network Time Protocol (NTP) server.

If you are running Docker Desktop on Mac OS, the kind container requires at least 6GB of RAM. For information about how to configure Docker Desktop so that it can run kind, see Settings for Docker Desktop in the kind documentation.

NOTE: If you have previously used Cluster API on the machine that you are using as your bootstrap environment, you must delete the ~/.cluster-api folder from that machine. This folder contains configuration files that might interfere with the correct interoperation of Cluster API and Tanzu Kubernetes Grid.

Download and Unpack the Tanzu Kubernetes Grid Bundle

  1. Go to https://www.vmware.com/go/get-tkg and log in with your My VMware credentials.
  2. Download the Tanzu Kubernetes Grid CLI to the machine to use as the bootstrap environment.

    • For Linux platforms, download tkg-linux-amd64-v1.0.0_vmware.1.gz.
    • For Mac OS platforms, download tkg-darwin-amd64-v1.0.0_vmware.1.gz.
  3. Use either the gunzip command or the extraction tool of your choice to unpack the binaries. Run either one of the following commands:

    gunzip  tkg-linux-amd64-v1.0.0_vmware.1.gz

    gunzip  tkg-darwin-amd64-v1.0.0_vmware.1.gz

    The unpacked files are tkg-linux-amd64 or tkg-darwin-amd64.

Install the Tanzu Kubernetes Grid CLI Binary

After you have downloaded and unpacked the Tanzu Kubernetes Grid CLI binary to your bootstrap environment, you must make it available to the system.

  1. Navigate to the executable for the Tanzu Kubernetes Grid CLI.

    cd download_location/tkg-linux-amd64-v1.0.0_vmware.1

    cd download_location/tkg-darwin-amd64-v1.0.0_vmware.1

  2. Rename the CLI binary for your platform to tkg, make sure that it is executable, and add it to your Path.

    1. Move the binary into the /usr/local/bin folder and rename it to tkg.
      mv ./tkg-linux-amd64 /usr/local/bin/tkg
      mv ./tkg-darwin-amd64 /usr/local/bin/tkg
    2. Make the file executable.
      chmod +x /usr/local/bin/tkg
  3. At the command line in a new terminal, run tkg to see help for the full list of commands and options that the Tanzu Kubernetes Grid CLI provides.

  4. Run tkg version to check that the correct version of the binary is properly installed.

    You should see information about the installed Tanzu Kubernetes Grid CLI version.

    Client:
      Version: v1.0.0
      Git commit: 60f6fd5f40101d6b78e95a33334498ecca86176e
    
  5. Run tkg --help to see the list of commands that the Tanzu Kubernetes Grid CLI provides.

    You can run any command with the --help option to see information about that specific command or sub-command. For example, tkg init --help or tkg create cluster --help.

    If you are running on Mac OS, you might encounter the following error:

    "tkg" cannot be opened because the developer cannot be verified.
    

    If this happens, you need to create a security exception for the tkg executable. Locate the tkg app in Finder, control-click the app, and select Open.

CLI Short Names and Aliases

Most of the Tanzu Kubernetes Grid CLI commands and options have short names or aliases, so that you do not have to type the full command and option names each time you run tkg. For example, -h for --help, and mc for management-cluster. For increased clarity, this documentation always uses the full command and option names. To see the shortnames and aliases for commands and options, run CLI commands with the --help option.

Common Tanzu Kubernetes Grid Options

The Tanzu Kubernetes Grid CLI provides common options that can be used with all of the CLI commands.

Option Description
--config The path to the management cluster configuration file, if it is not stored in the default location, $HOME/.tkg/config.yaml. For example, tkg init --ui --config=/path/my-config.yaml.
--help Show help for the current command. For example, tkg create cluster --help.
--kubeconfig The path to the kubeconfig file for the management cluster, if it is not stored in the default location.
--log_file Specify a file in which to save the logs for the current command. For example, tkg scale cluster my-cluster --worker-machine-count=9 --log_file=my-cluster-scale-logs.
--quiet Mute all output for the current command.
--v Set the logging verbosity level for the command.

What to Do Next

The Tanzu Kubernetes Grid CLI is ready to use. You can use the Tanzu Kubernetes Grid installer interface or CLI to deploy a management cluster to either vSphere or Amazon EC2.

If you have vSphere 7.0 and the vSphere with Kubernetes feature is enabled, you can directly use the Tanzu Kubernetes Grid CLI to deploy Tanzu Kubernetes clusters to vSphere with Kubernetes. For information about how to connect the Tanzu Kubernetes Grid CLI to a vSphere with Kubernetes Supervisor Cluster, see Use the Tanzu Kubernetes Grid CLI with a vSphere with Kubernetes Supervisor Cluster .