Deploy Workload Clusters to Your Own Host (Experimental)

This topic explains how to deploy workload clusters to your own physical or virtual host machines.

About Deploying Workload Clusters to Your Own Hosts

After you have created the management cluster on vSphere, or Azure, you can start deploying workload clusters to your own physical or virtual hosts. To deploy a workload cluster to your own physical or virtual hosts, you must initialize the Bring Your Own Host (BYOH) Cluster API Infrastructure Provider on the management cluster, install Host Agent on them, create a configuration file for the cluster, and then create the cluster.

BYOH Cluster API Infrastructure Provider

BYOH is a Cluster API infrastructure provider that runs in the management cluster and instructs Host Agent (see below) to create, scale, and delete Kubernetes nodes on your hosts. When using BYOH as the infrastructure provider, Tanzu Kubernetes Grid manages node provisioning and lifecycle, including the installation of Kubernetes and its components on the hosts, and you are responsible for setting up and managing the infrastructure layer, including your host operating system (OS). For example, if the BYOH infrastructure provider receives a request to scale up the number of nodes in a workload cluster, the operation will be completed only if the requested infrastructure resources, or hosts, are available in your BYOH environment.

General Prerequisites for Cluster Deployment

  • Each cluster requires one static virtual IP address to provide a stable endpoint for Kubernetes. Make sure that this IP address is not in the DHCP range, but is in the same subnet as the DHCP range.


In this version of Tanzu Kubernetes Grid, the BYOH infrastructure provider supports physical Linux hosts. When using BYOH, each Kubernetes node runs on a separate host. For example, if you want to create a workload cluster with three control plane and three worker nodes, you must allocate six hosts to the cluster.

Host Agent

Host Agent is a process that runs on hosts, in privileged mode, and registers them with the management cluster. When Host Agent is running on a host, it can communicate with the BYOH infrastructure provider on the management cluster. Host Agent transforms your hosts into Kubernetes nodes as well as scales and deletes them.

Host Requirements

Resource Requirements

Resource requirements, supported hardware, etc.

OS Requirements

Ubuntu 20.04

Prerequisites with a vSphere Management Cluster

Prerequisites with an Azure Management Cluster

check-circle-line exclamation-circle-line close-line
Scroll to top icon