Skip to main content

How to Install Tanzu Kubernetes Grid

Michael M.
Updated

Objective

This guide documents how to install Tanzu Kubernetes Grid on your Hosted Private Cloud powered by VMware cluster.

Introduction

VMware Tanzu Kubernetes Grid is a Kubernetes platform provided by VMware and maintained as part of the Hosted Private Cloud powered by VMware solution.

You can install this product on your OVHcloud infrastructure to take advantage of its features and scalability.

Requirements

  • Being an administrative contact of your Hosted Private Cloud infrastructure to receive login credentials
  • A user account with access to the OVHcloud Control Panel
  • A user account with access to vSphere
  • A VLAN with internet access and a DHCP server
  • You must have these resources:
    • 8 GB of memory, 4 vCPUs, and 250 GB of storage for the management virtual machine named Bootstrap.
    • 16 GB of memory, 4 vCPU, 40 GB of storage per Kubernetes node (it takes 6 nodes to install the management cluster in production mode and 6 nodes per Workload cluster in the same mode).

Instructions

We will install VMware Tanzu Kubernetes Grid on a Hosted Private Cloud powered by VMware cluster and use VLAN 10 with these settings:

  • LAN: 192.168.0.0/24.
  • DHCPRange: 192.168.0.50 -> 192.168.0.100.
  • Gateway: 192.168.0.254.
This information is given as an example, it is quite possible to use another range and another VLAN.

At the end of the installation, seven additional virtual machines will be on your VMware cluster, six for running the TKG management cluster and one for managing it.

install1.png

Importing OVA model for Tanzu KUBERNETES Grid into your infrastructure

VMware provides a virtual machine as an OVA template, which contains all the elements to run a node of the Tanzu Kubernetes Grid cluster. This virtual machine is available in OVH Templates.

Log into the OVHcloud homepage for your VMware cluster, and click OVH Templates to the right.

install2.png

In the Select a template window, choose the fourth template from the top that has this information:

  • Family: Linux
  • Distribution: not specified
  • Version: 3

install3.png

Click the Copy icon to the right to copy the URL which name must end in photon-3-kube-v1.23.8+vmware.1.ovf. Then click Close.

install4.png

Log in to your vSphere console, right-click your cluster and choose Deploy an OVF Template.

install5.png

Select URL, paste the previously copied URL and click NEXT.

install6.png

Leave the default location and click NEXT.

install7.png

Choose the cluster and click NEXT.

install8.png

Review your information and click NEXT.

install9.png

Check I accept all licence agreements and click NEXT.

install10.png

Select a shared storage in NFSv3, then click NEXT.

install11.png

Choose the destination network on VLAN 10 and click NEXT.

install12.png

Click FINISH.

install13.png

Select the Monitor tab and click Tasks.

install14.png

Wait for the Deploy OVF template and Import OVF package tasks to complete.

install15.png

Right-click the deployed VM and choose Convert to Template from the Template menu.

install16.png

Answer YES to convert the virtual machine.

install17.png

Go to Virtual Machines (and templates) to see the template you have created.

This template will be used when deploying Tanzu Kubernetes Grid clusters. It is used for the initial deployment of the administration cluster and for the installation of additional WorkLoad clusters. It should not be deleted from the VMware cluster.

install18.png

Installation of the virtual machine Bootstrap provided by OVHcloud

This virtual machine was created by OVHcloud from the documentation Installing the CLI tool manually for deploying Tanzu Kubernetes GRID. It is available as a template in OVH Templates.

Log into the OVHcloud homepage for your VMware cluster, and click OVH Templates to the right.

install19.png

In the Select a template window, choose the third template from the top that contains this information:

  • Family: Linux
  • Distribution: Ubuntu
  • Version: 22

install20.png

Click the Copy icon to the right to copy the URL, the URL should end with Ubuntu-22.04_TKGm-1.6_with_x.ovf. Then click Close.

install21.png

In the vSphere interface, right-click the cluster and choose Deploy an OVF Template from the menu.

install22.png

Select URL, paste the previously copied URL and click NEXT.

install23.png

Leave the default positioning and click NEXT.

install24.png

Leave Cluster1 and click NEXT.

install25.png

Click NEXT to validate your choices.

install26.png

Select a shared storage in NFSv3 and click NEXT.

install27.png

Choose VLAN10 for the destination network and click NEXT.

install28.png

Add this information in Networking:

  • Hostname: bootstrap
  • IPAddress: 192.168.0.199
  • NetworkCIDRPrefix: 24
  • Gateway: 192.168.0.254
  • DNS: 213.186.33.99
The DNS server chosen in this guide is the OVHcloud server.

Enter and confirm the password in OS Credentials and click NEXT.

install29.png

Click FINISH.

install30.png

Right-click the virtual machine you created, go to Power and click Power On.

install31.png

The booted virtual machine can be accessed via the console with the graphical interface or via SSH.

Go to the virtual machine you have created, and click LAUNCH WEB CONSOLE.

install32.png

The graphical interface for the Linux virtual machine is then available.

install33.png

Allowing access to the PCC cluster from the Bootstrap virtual machine

The configuration and administration tools for Tanzu Kubernetes Grid are installed on the Bootstrap virtual machine. This virtual machine must be able to connect to the Internet and to the vSphere cluster.

Write down the public IP address you use on this virtual machine and use this guide Authorize IP addresses to connect to vCenter to grant access to the vSphere cluster to the new virtual machine.

Deploying the Tanzu Kubernetes Grid cluster on your infrastructure

Log in to the Ubuntu-22.04_TKGm-1.5.4_with_x virtual machine, open a terminal, and run this command to create an RSA key:

ssh-keygen -t rsa -b 4096 -C "youremail@yourdomain.com"

install34.png

Two files are created in the ~/.ssh folder:

  • id_rsa.pub
  • id_rsa

Stay on the console and run this command:

tanzu management-cluster create --ui --bind 192.168.0.199:8080
When you run this command from the Linux console with the graphical interface, the web browser launches and connects to https://192.168.0.199:8080. If you have run this command from an SSH connection, you will need to connect to https://192.168.0.199:8080 from a virtual machine on the same network with a graphical interface and an operational web browser.

install35.png

Click Deploy below VMware vSphere.

install36.png

Enter this information:

  • VCENTER SERVER: VMware cluster FQDN
  • USERNAME: VMware cluster user
  • PASSWORD: VMware cluster user password

Then click CONNECT.

install37.png

At the verification step of the SSL Thumbprint, click CONTINUE.

install38.png

Click the cross in the top right to close the vSphere 7.0.3 Environment Detected window.

install39.png

Paste the contents of the ~.ssh/id_rsa.pub file into SSH PUBLIC KEY and click NEXT.

install40.png

Select Production on the right and select the large etc... INSTANCE TYPE.

Enter these values:

  • MANAGEMENT CLUSTER NAME (OPTIONAL): tkgm-management-cluster.
  • CONTROL PLANE ENDPOINT: 192.168.0.10.

Click NEXT to proceed to the next step.

install41.png

Click NEXT.

install42.png

In the Metadata option and then in the LABELS (OPTIONAL) section, type tkgm for the name and its value.

Click NEXT.

install43.png

Enter these options:

  • VM FOLDER:  Storage folder for virtual machines.
  • DATASTORE:  Storage of virtual machines to be placed on a shared storage.
  • CLUSTERS, HOSTS, AND RESOURCE POOLS:  Cluster1.

Click  NEXT.

install44.png

In NETWORK NAME select VLAN10.

Click NEXT.

install45.png

Disable the Activate Identity Management Settings option and click NEXT.

install46.png

Select the OVA image integrated into the photon-3-kube-v1.22.9+vmware.1 cluster from the OS Image menu and click NEXT.

install47.png

Uncheck Participate in the Customer Experience Improvement Program and click NEXT.

install48.png

Click REVIEW CONFIGURATION.

install49.png

Take note of the name of the yaml file below CLI Command Equivalent, it will serve as a template for deploying a WorkLoad cluster.

Scroll through the window and click DEPLOY MANAGEMENT CLUSTER.

install50.png

The Tanzu Kubernetes Grid cluster deployment is started, please wait for it to complete.

The deployment will be completed when you see the Management cluster created and Successfully installed all required plugins messages in the window.
install51.png
Another indication that the installation is complete can be found in the console of the Bootstrap virtual machine in which will appear the Management cluster created and You can now create your first workload cluster etc… messages.
NOTE: Write down or copy the name of the yaml file in the /home/tanzu/.config/tanzu/tkg/clusterconfigs folder, it will be used to create a configuration file for installing a WorkLoad cluster.

install52.png

Go to the vCenter interface to see the seven virtual machines created.

install53.png

Related articles