Create a cluster

Place to live

To create a new cluster, select a MetaKube Project from login page and click the button entry Add Cluster. Clusters are tied to a project. You can create as many clusters within one project as you want.

Overview of cluster creation

Start by choosing a provider and region:

Menu to chose cloud provider

Create the cluster

In the next step of the installer, enter your cluster details into the Cluster tab:

Overview of cluster settings

Then add your cloud credentials the Settings tab.
You have the option to use Openstack Application Credentials or Username, Password and Tenant combination.
We suggest to use application credentials because they are not user bound, and they allow you to have single purpose access data that you won't need to change if you, for example, change your password.

By default, Metakube will automatically set up the following Openstack resources for a new cluster:

  • Network metakube-<cluster id> with IPv4 subnet metakube-<cluster-id> with subnet CIDR
  • Security group metakube-<cluster-id> for the worker nodes with all necessary rules
  • Server group metakube-<cluster-id> with soft-anti-affinity to spread nodes across different hardware nodes

Please don't change any Advanced Configuration settings if you don't have any special requirements.
For more information see Advanced Configuration

Overview of cluster cloud settings

For node settings we recommend at least 3 nodes sized m1.small or bigger. For an overview of the possible node flavors see the SysEleven Stack documentation. It is also possible to choose the operating system and image used for your worker nodes:

Overview of cluster settings with highlighted node section

We provide Ubuntu and Flatcar for your cluster nodes OS, with Ubuntu as default. You can also choose a different image available at your Openstack tenant. To get a list of base images, navigate to Project -> Compute -> Images in the SysEleven Stack dashboard:

Overview of openstack images

Make sure to enter the exact name of the image you want to run on your machines, as listed in the images tab of the SysEleven stack dashboard. See also supported operating systems.
The chosen SSH key added in the Cluster tab will be used for authentication for the default user (e.g. ubuntu for Ubuntu images) on all worker nodes.

When you click on next, you will see a summary and the cluster creation will start after you confirm. You will then be forwarded to the cluster creation page where you can view the cluster creation process:

Cluster summary before creation
Cluster details in creation state

After all of the master components are ready, your cluster will create the configured number of worker nodes in your SysEleven Stack tenant. Fully created nodes will be marked with a green dot, pending ones with a yellow circle. You can then download the kubeconfig by clicking the button Download Config to be able to use kubectl with your cluster or use the provided Web Terminal. After all nodes are created you can use kubectl to view and check the status of the created nodes:

$ kubectl get nodes
NAME                          STATUS    ROLES     AGE       VERSION
metakube-w9tk8cmw62-22wgv     Ready     <none>    1m        v1.20.4
metakube-w9tk8cmw62-58pd6     Ready     <none>    1m        v1.20.4
metakube-w9tk8cmw62-hm5vl     Ready     <none>    1m        v1.20.4