Creating Kubernetes Cluster on vSphere with Kublr

Prerequisites

The Kublr Demo/Installer must be installed. If you haven’t done that yet, please refer to the Installation Guide for the Kublr Demo/Installer.

System requirements for the cluster nodes:

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

Overview

Steps below describe how to use Kublr to create VMware vSphere Kubernetes cluster. The following steps are described:

Preparing virtual machine template in vCenter.
Creating Kubernetes cluster on vSphere with Kublr.

Preparing Virtual Machine Template in vCenter

Kublr can use two kinds of VM templates:

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

For a quick start, you can prepare VM template with installed cloud-init:

Creating a VMware vSphere cluster with Kublr

To add a new cluster:

On the left menu, click Clusters.
Click Add Cluster. The Select Installation Type dialog is displayed.
In the Select Installation Type dialog, select Platform or Cluster.
Click Continue Setup. The add cluster/platform dialog is displayed.
Set Provider to “VMware vSphere”.
From the Credentials list, select previously created VMware vSphere credentials.
If credentials were not created previously, use Add New Credentials.
Specify Cluster Name.
Set in order listed:
- Datacenter
- Resource Pool
- Datastore Type and Datastore
- Kubernetes Version
Optionally, set Advanced Options.
Scroll to the Network Configuration section.
Set:
- Network
- Network CIDR
Optionally, set Advanced Options.
Use the INSTANCES tab.
Use the Master Configuration section.
Specify the parameters of the master node(s) of your cluster as described below.
From the Masters list, select the number of master nodes.
Set Master X: IP for each node.
For 3 and 5 master nodes configuration, optionally specify Load Balancer Address.
Select from lists:
- VM Template (If you don’t have template, please create one as specified here.)
- VM Initialization Type
Set:
- Number of CPUs cores to use per VM.
- Amount of RAM in GB to use per VM.
Optionally, set Advanced Options.
Scroll to the instance group section (default name group1).
Specify the parameters of the worker node(s) in your group as described below.
Select IP Address Allocation Mode.
Enter number of Nodes to be provisioned in the node group.
Select from lists:
- VM Template (If you don’t have template, please create one as specified here.)
- VM Initialization Type
Set:
- Number of CPUs cores to use per VM.
- Amount of RAM in GB to use per VM.
If necessary, set your own name for the instance group.
Note For your working nodes, you can have as many instance groups as you need (clone or delete the current instance group, or add another one). If necessary, give specific name to each group.
Optionally, set Advanced Options.
Use the FEATURES tab to select and configure FEATURES that you want to include into your cluster.
Click the REVIEW & CREATE step.
Review your cluster parameters.
At the bottom of the dialog, click CONFIRM AND INSTALL.
A notification is displayed “Your cluster is being created. It might take a few minutes.”
In the notification window, click OK.
Your new cluster page is displayed on the Events tab showing the cluster creation progress.

Creating Kubernetes Cluster on vSphere with Kublr

Prerequisites

Overview

Preparing Virtual Machine Template in vCenter

Creating a VMware vSphere cluster with Kublr

Congratulations! You have just deployed a VMWare vSphere cluster in Kublr

See also