Create a Kubernetes cluster on vCloud Director with Kublr



This page provide users with a quick overview on how to create a VMware vCloud Director cluster.


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

Before you get started

First download and install Kublr-in-a-box at Kublr support vCloud Director 9.0 and above.


System requirements for the cluster nodes

  1. x86 64-bit hardware
  2. At least 4Gb of RAM per master node and per work node
  3. At least 32Gb 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
  5. Root access to each node
  6. Nodes are connected in your network and Kublr-in-a-box configured IP is accessible from these nodes (ping)
  7. 100Mb stable internet connection

Prepare a virtual machine template in vCloud Director

Next, prepare a VM template:

  1. vAppTemplate must contain exactly one VM
  2. It must be one of supported linux distributives (Ubuntu/Debian/RHEL/CentOS and etc)
  3. open-vm-tools package must be installed
  4. Guest OS Customization must be enabled in VM properties

More details are available in vCloud Director documentation

Creating VMware vCloud Director cluster in Kublr

  1. Click Clusters from the menu in the left navigation menu bar
    vCloud cluster menu
  2. Click the Add Cluster
    vCloud Add Cluster
  3. Enter a cluster name
    vCloud Cluster name
  4. Select the provider VMware vCloud Director
    vCLoud Select provider
  5. Create VMware vCloud Director Credentials or select existing credentials. Kublr will access your VMware using your VMware VCloud Director credentials. All cluster resources, such virtual machines, are created within your VMware Project using VMware API and will be managed by Kublr.
    vCloud credentials
  6. Select an existing Virtual Data Center to use. If you need to create new one, use vCloud Director console.
    vCloud Virtual DC
  7. You can use only one Network Type. Select Organization network for the cluster
    vCound network
  8. Select the number of Master Nodes and IP Address Allocation Mode (Static Pool, Dynamic (DHCP), Manual)
    vCLoud IP Addresses
  9. Select vApp Template (OS image) for Master Node
    Note: vAppTemplate should be prepared
    vCLoud vAppTemplate
    In advanced options you can set custom parameters for VM (Number of CPU cores to use per VM, Amount of RAM to use per VM, storage profile for disks)
    vCloud advanced node
  10. Select number of Worker Nodes and IP Address Allocation Mode and vApp Template for them. In advanced options you should set RAM at more than the default (e.g. 6000 MB)
    vCloud UP allocation mode
  11. Click Confirm and Install button
    vCloud Confirm and Install
  12. Wait until cluster is switched to Running status
    vCloud deployed cluster

Congratulations! You’ve just deployed a vCloud Director cluster in Kublr