Kubernetes Cluster

On this page, you can find an explanation of how to create and manage Kubernetes Cluster in the Cloud Console.

Table of contents

  1. Clusters Page
  2. Create a Cluster
  3. Get Kubeconfig of the Cluster
  4. Resize a Cluster
  5. Delete a Cluster
  6. Cluster details page

Clusters page

To get to the Clusters page on the Homepage you need to select the Clusters from the VIRTUAL DATACENTER block:

clusters

This action will redirect you to the Clusters page where you can find all created Clusters with their HeadersCreate buttonSearch bar and Actions icon which opens a list of available management actions for the selected Cluster:

cl1-1

Cluster headers include:

  • Name: shows the name of the Cluster;
  • Status: shows the Cluster state;
  • ID: shows the Cluster ID;
  • API Address: shows the Cluster API Address;
  • Region: shows which regions the corresponding Clusters belong to;
  • Master Flavor: holds information about the Master-node memory, disk space and the number of virtual CPUs that will be available;
  • Node Flavor: holds information about the Worker-nodes memory, disk space and the number of virtual CPUs that will be available
  • Health: shows the Cluster health state;
  • Updated at: shows date when the Cluster was updated last time.

Actions icon opens the next list of available management actions:

  • Download kubeconfig file - by this option you can get the kubeconfig file that pertains to the selected Cluster;
  • Edit - by selecting this option you can change the count of Worker-nodes in the selected Cluster;
  • Delete - this option is for Cluster removing.

So, from this page you can:

  • review all created Clusters;
  • create more Clusters;
  • download kubeconfig file of the Cluster;
  • resize Cluster (change the count of Worker-nodes);
  • delete unnecessery Clusters.

Create a Cluster

To create a new Cluster do the following:

  • go to the Clusters page and click the CREATE Cluster icon in the upper left corner:

 cl4-1

  • on the next opened Create Cluster window specify:
    • Name: in this field you set a name for the Cluster, it can contain only Latin letters (a-z, A-Z), digits (0-9), hyphen (-), underscore (_) and must be at most 255 characters long;
    • Cluster Template: here you select the template that will be used to create this Cluster;
    • Master Node Flavor: in this field you select the size of the Cluster master-nodes (min is VC-2);
    • Node Flavor: in this field you select the size of the Cluster worker-nodes (min is VC-2);
    • Keypair: in this field, you need to select the SSH Keypair that was previously created on the Keypair page or create a new one; SSH Keypair you will use to configure in the Cluster servers for ssh access.
    • Docker volume size (GB): here you provide the preferred disc size where container images will be stored, it can be specified in the range from 10 GB to 1000 GB. The size of 50 GB is selected by default;
    • Master Count: here you set how many master-nodes the Cluster will contain. The default is 1;
    • Node Count: here you set how many worker-nodes the Cluster will contain. The default is 1;

cl3-1

After fields were specified, click on CREATE button and the newly created Cluster will be added to the Clusters page with the status Created (Estimate creation time about 5 minutes):

cl7-1

Get Kubeconfig of the Cluster

NOTE:
The kubeconfig file is required to configure access to a cluster and switch between multiple clusters, multiple users, and with different authentication mechanisms such as passwords or tokens.

To download the kubeconfig file that pertains to a Cluster do the following:

  • to identify this desired Cluster on the Clusters page;
  • click on the Actions icon  ssh9  and select the Download kubeconfig file in the list of available options;
After these steps, the kubeconfig file will be downloaded.

Resize a Cluster

To resize a Cluster do the following:

  • to identify the Cluster you want to resize on the Clusters page;
  • click on the Actions icon  ssh9  and select the Edit in the list of available options;
  • on the next opened Edit Cluster window, update the count of Worker-nodes in the Cluster and click on the SAVE  icon:

cl11

After these steps, the selected Cluster will be updated.

Delete a Cluster

To delete a Cluster do the following:

  • to identify this unnecessary Cluster on the Clusters page;
  • click on the Actions icon  ssh9  and select the Delete in the list of available options;
  • on the next opened Confirmation window the Cluster deletion:

cl12

After these steps, the selected Cluster will be deleted (estimate time 5 min).

Cluster details page

To open the Cluster details page you need to click on the Name of the corresponding Cluster:

cl05

This action will redirect you to the Cluster  details page, where you can find four tabs with additional information about selected Cluster:

  • INFO Tab - here you can find next information:
    • ID of the selected Cluster;
    • Current Status of the selected Cluster;
    • Date when the Cluster was created;
    • Date of the last update of the Cluster;
    • Cluster template:
cl01
  • NODES Tab - holds the following information:
    • Master count;
    • Node count;
    • API address of the Cluster;
    • IP addresses of the Master-node;
    • IP addresses of the Worker-nodes:
cl02
  • MISCELLANEOUS Tab - holds the next information:
    • Discovery URL of the selected Cluster;
    • Cluster create timeout;
    • Key pair that was used during the Cluster creation;
    • Master flavor;
    • Node flavor;
    • Health status of the selected Cluster:
cl03
  • LABELS Tab - holds some additional information too:
cl04