Deployed Kubernetes node-pools have repetitive naming

Products

• VMware vSphere Kubernetes Service

Issue/Introduction

VMs and nodes deployed by Kubernetes clusters are repetitive in how they are named.

When viewing the node-pool configuration in the cluster YAML or Organization Portal, the node-pool only has the cluster name once.

For example, a node-pool could be named similarly to: "my-cluster-np-1"

However, the VMs and nodes created have the cluster name twice.

For example, the VMs and nodes are named similarly to: "my-cluster-my-cluster-np-1-abcde"

Environment

vSphere Supervisor

Cause

This is the standard naming convention of the product.

All VMs created from a Kubernetes cluster will follow the below naming convention:

cluster-name-nodepool-name-unique-id

For each node-pool, there is a machineDeployment (md) kubernetes resource created which is named after the node-pool defined in the cluster:

Cluster Name: my-cluster
Node-pool Name: nodepool-1

my-cluster-nodepool-1-abcde

For control plane nodes, an unique-id is automatically generated which is shared (similarly to a node-pool name) by all control plane nodes:

Cluster Name: my-cluster

my-cluster-zyxwv-qrstu

The system will automatically generate an unique-id and append it to the VM/node's name to ensure that each VM and node has an unique name corresponding to its cluster.

This is also a form of version control.

Resolution

This is expected behavior of the product.

If you are seeing duplicate names in your cluster, your node-pool's name contains the the name of the cluster.

For example:

Cluster Name: my-cluster

Node-pool Name: my-cluster-np-1

This will result in VMs for that node-pool named similarly to:

my-cluster-my-cluster-np-1-<unique-id>

 

You can rename the node-pool(s) of an existing cluster. 

Note: Renaming a node-pool will result in a rolling redeployment/re-creation of all VMs in that node-pool.

For example:

Cluster Name: my-cluster

Node-pool Name: np-1

This will result in VMs for that node-pool named similarly to:

my-cluster-np-1-<unique id>

Additional Information

Using the Resources tab of a namespace to create Kubernetes clusters will default to using the cluster's name in the nodepool's name.

The Resources tab of a namespace is managed by the Local Consumption Interface (LCI/CCI).