Instalación de Tanzu Kubernetes Grid (EN)

Learn how to integrate Tanzu Kubernetes Grid into your Hosted Private Cloud powered by VMware infrastructure

Last updated 10th November 2022

Objective

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

OVHcloud provides services for which you are responsible, with regard to their configuration and management. It is therefore your responsibility to ensure that they work properly.

This guide is designed to assist you as much as possible with common tasks. However, we recommend contacting a specialist provider if you experience any difficulties or doubts when it comes to managing, using or setting up a service on a server.

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.
  • DHCP Range: 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.

00 admin cluster diagram

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 in to the OVHcloud homepage for your VMware cluster, and click OVH Templates to the right.

01 integrate TKGM OVA 01

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

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

01 integrate TKGM OVA 02

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.

01 integrate TKGM OVA 03

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

01 integrate TKGM OVA 03b

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

01 integrate TKGM OVA 04

Leave the default location and click NEXT.

01 integrate TKGM OVA 05

Choose the cluster and click NEXT.

01 integrate TKGM OVA 06

Review your information and click NEXT.

01 integrate TKGM OVA 07

Check I accept all licence agreements and click NEXT.

01 integrate TKGM OVA 08

Select a shared storage in NFS v3, then click NEXT.

01 integrate TKGM OVA 09

Choose the destination network on VLAN 10 and click NEXT.

01 integrate TKGM OVA 10

Click FINISH.

01 integrate TKGM OVA 11

Select the Monitor tab and click Tasks.

01 integrate TKGM OVA 12

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

01 integrate TKGM OVA 13

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

01 integrate TKGM OVA 14

Answer YES to convert the virtual machine.

01 integrate TKGM OVA 15

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.

01 integrate TKGM OVA 16

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 in to the OVHcloud homepage for your VMware cluster, and click OVH Templates to the right.

02 Add Bootstrapvm 01

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

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

02 Add Bootstrapvm 02

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.

02 Add Bootstrapvm 03

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

02 Add Bootstrapvm 03b

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

02 Add Bootstrapvm 04

Leave the default positioning and click NEXT.

02 Add Bootstrapvm 05

Leave Cluster1 and click NEXT.

02 Add Bootstrapvm 06

Click NEXT to validate your choices.

02 Add Bootstrapvm 07

Select a shared storage in NFS v3 and click NEXT.

02 Add Bootstrapvm 08

Choose VLAN10 for the destination network and click NEXT.

02 Add Bootstrapvm 09

Add this information in Networking:

  • Hostname: bootstrap
  • IP Address: 192.168.0.199
  • Network CIDR Prefix: 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.

02 Add Bootstrapvm 10

Click FINISH.

02 Add Bootstrapvm 11

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

02 Add Bootstrapvm 12

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.

02 Add Bootstrapvm 13

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

02 Add Bootstrapvm 14

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 Authorise 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"

03 Create TKG CLUSTER 01

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.

03 Create TKG CLUSTER 02

Click Deploy below VMware vSphere.

03 Create TKG CLUSTER 03

Enter this information:

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

Then click CONNECT.

03 Create TKG CLUSTER 04

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

03 Create TKG CLUSTER 05

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

03 Create TKG CLUSTER 06

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

03 Create TKG CLUSTER 07

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.

03 Create TKG CLUSTER 08

Click NEXT.

03 Create TKG CLUSTER 09

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

Click NEXT.

03 Create TKG CLUSTER 10

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.

03 Create TKG CLUSTER 11

In NETWORK NAME select VLAN10.

Click NEXT.

03 Create TKG CLUSTER 12

Disable the Activate Identity Management Settings option and click NEXT.

03 Create TKG CLUSTER 13

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

03 Create TKG CLUSTER 14

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

03 Create TKG CLUSTER 15

Click REVIEW CONFIGURATION.

03 Create TKG CLUSTER 16

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

03 Create TKG CLUSTER 17

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.

03 Create TKG CLUSTER 18

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.

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

03 Create TKG CLUSTER 19

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

04 VM CREATED ADFTER INSTALLATION 01

Go further

Administrating a TKG cluster

Introducing VMware Tanzu Kubernetes Grid

Documentation de VMware Tanzu Kubenetes Grid

Manual installation of the CLI tool for the deployment of Tanzu Kubernetes GRID

Join our community of users on https://community.ovh.com/en/.


¿Le ha resultado útil esta guía?

Si lo desea, también puede enviarnos sus sugerencias para ayudarnos a mejorar nuestra documentación.

Imágenes, contenido, estructura...: ayúdenos a mejorar nuestra documentación con sus sugerencias.

No podemos tratar sus solicitudes de asistencia a través de este formulario. Para ello, haga clic en "Crear un tíquet" .

¡Gracias! Tendremos en cuenta su opinión.


Otras guías que podrían interesarle...

OVHcloud Community

¡Acceda al espacio de la OVHcloud Community! Resuelva sus dudas, busque información, publique contenido e interactúe con otros miembros de la comunidad.

Discuss with the OVHcloud community

A partir del 1 de enero de 2015, con arreglo a la Directiva 2006/112/CE modificada, los precios IVA incluido pueden variar según el país de residencia del cliente (por defecto, los precios con IVA incluyen el IVA español vigente).