Using vSphere Host Groups with Enterprise PKS

Page last updated:

Topic provided by VMware

This topic describes how to use vSphere Host Groups with Enterprise Pivotal Container Service (Enterprise PKS).

About vSphere Host Groups

In vSphere, a cluster is a collection of EXSi servers that run virtual machines (VMs). A typical way to organize resources within a cluster is using resource pools. A resource pool is a collection of vSphere resources.

Another way to segment resources within a cluster is using host groups. This means that within a cluster object you can specify certain ESXi hosts to be part of a host group.

Enterprise PKS users can define host groups in vSphere, then in the PKS tile can specify the host group. Host groups align with the Availability Zone (AZ) construct in BOSH.

For more information on vSphere host groups, refer to the vSphere documentation.

Host Group Use Cases for Enterprise PKS

This subsection describes use cases for using host groups with Enterprise PKS.

Enabling Support for vSAN Fault Domains

The vSAN fault domains feature instructs vSAN to spread redundancy components across the servers in separate computing racks. In this way, you can protect the environment from a rack-level failure such as loss of power or connectivity. For more information, see Designing and Sizing vSAN Fault Domains in the VMware documentation.

Fault domains map to host groups. If you have set up fault domains in your vSAN architecture, you can now leverage host groups with PKS.

Using Host Group as a New AZ in BOSH

Previously, the two types of AZs available with PKS on vSphere were Datacenter and Datacenter plus Resource Pool. Host groups gives you a third option: Datacenter plus HostGroups.

In the case of multi-master Kubernetes clusters, with the Datacenter and Datacenter plus Resource Pool AZs, there is no guarantee that master nodes will reside on separate ESXi hosts. With the Datacenter plus HostGroups AZ you can guarantee that Kubernetes master nodes will reside on separate ESXi hosts.

Defining a Host Group in vSphere

To implement host groups with Enterprise PKS, the first step is to define a host group in vSphere.

  1. Log in to vCenter.
  2. Select the compute Cluster.
  3. Select the Configure tab.
  4. Under Configuration, select VM/Host Groups.
  5. Click Add and configure the host group as follows:
    • Name: Enter a name for the host group.
    • Type: Select Host Group from the drop down.
    • Click Add and select the ESXi host(s) to include in the host group.
    • Click OK.
  6. Once done, you should see that the host group is configured.

Using a Host Group with Enterprise PKS

Once the host group is defined in vSphere, the next step is to declare this host group when defining the BOSH Availability Zone (AZ) for use with Enterprise PKS.

  1. Log in to Ops Manager.
  2. Select the BOSH Director tile.
  3. Select the Create Availability Zones tab.
  4. Select the desired AZ, or create a new one.
  5. In the Clusters section, enter the name of the Host Group.
  6. Click Save.

Please send any feedback you have to pks-feedback@pivotal.io.