Create a Kubernetes cluster w/ vSphere



Quick overview on how to create VMware vSphere Kubernetes clusters through the Kublr Platform.


Deploy simple 1 master and 2 work node Kubernetes clusters for demo purposes.

Before you get started

First download and install Kublr-in-a-box at


System requirements for the cluster nodes

  1. x86 64-bit hardware
  2. At least 5Gb of RAM and 2 vCPU per master node
  3. At least 16Gb og RAM and 8 vCPU in sum for work nodes if you plan deploying Kublr Platform
  4. Supported OS on nodes: Ubuntu 16.04 LTS and above, RHEL 7.4 and above, CentOS 7.4 and above
  5. Direct connection to the virtual machine network
  6. Direct connection to vCenter and ESXi hosts
  7. 100Mb stable internet connection

Prepare a virtual machine template in vCenter

Kublr can use two kinds of VM templates:

  1. With installed vm-tools (This case is used for custom VM templates)
  2. With installed cloud-init (This case is used for prepared VM templates from the vendor)

For a quick start, you can use a prepared VM template with installed cloud-init from ova template.

You can upload this template to vCenter in two ways:

  1. Upload through vCenter UI
  2. Upload through govc import.ova

Creating a VMware vSphere cluster in Kublr

  1. Click Clusters from the menu in the left navigation menu bar
    vSphere cluster menu
  2. Click the Add Cluster
    vSphere Add Cluster
  3. Enter a cluster name
    vSphere Cluster name
  4. Select the provider VMware vSphere
    vSphere Select provider
  5. Create VMware vSphere Credentials or select existing credentials
    vSphere credentials Data center will be loaded according your …
    vSphere DC
  6. Select Resource Pool
    Note: Before creating a cluster, make sure that sufficient resources are reserved in the resource pool. If the resource pool type is expandable, then it can borrow resources from the parent resource pool. If resource pool type is fixed and it does not has enough resources then cluster creation cannot be performed. More information about resource pool you can find in your vCenter
    vSphere resources
  7. Select Datastore Type and Datastore
    vSphere DataStore type
  8. Select vSphere Network that will be used by cluster. Kublr supports all network types provided by vSphere including NSX-T
    vSphere network type
  9. Select Number of Master Nodes and VM Template.
    For some Templates you should create Username/Password Credentials used by Kublr to access VM during initialization
    vSphere master nodes
  10. Select the number of work nodes. In the advanced options you should set RAM at more than the default (e.g. 6000 MB)
    vSphere worker nodes
  11. Click Confirm and Install button
    vSphere Confirm and Install
  12. Wait until cluster is switched to Running status
    vSPhere deployed cluster

Congratulations! You’ve just deployed a VMWare vSphere cluster in Kublr