Creating Clusters
Creating Clusters in the Control Panel
To create a Kubernetes cluster in the Control panel:
-
Go to the Kubernetes section in the project.
-
Click Create cluster.
Please note that you can create two Kubernetes clusters in a single project of one pool.
-
Enter Cluster name. The cluster name will be displayed in the names of the cluster entities: node groups, nodes, load balancers, networks, and volumes. For example, if the cluster name is kelsie, then the node group name will be kelsie-node-gdc8q, and the boot volume name will be kelsie-node-gdc8q-volume.
-
Specify the Pool. Learn more about pools. It is impossible to change the pool for the created cluster.
-
Select the Kubernetes version. Versions 1.16.x, 1.17.x, 1.18.x, 1.19.x and 1.20.x are now available. Please note that it is possible to update the Kubernetes version in a running cluster.
-
Select the Cluster type:
- regional — 3 master nodes are created distributed in several pools. Control Plane will continue to work if one of the three master nodes is down;
- zonal — 1 master node is created in one availability zone. Control Plane will be out of work if there is a downtime on a master node.
-
Node groups combine nodes of the same configuration in a single zone. Configure the nodes in the group: select the zone, configuration (vCPU, RAM, boot volume), number of nodes, labels, SSH key. Specify the number of nodes in the group.
-
Add the required number of node groups by clicking Add node group.
Please note that you can create a cluster with node groups in different pools where this is possible. This allows you to keep the app available in the event of an accident in one of the zones.
-
Select the private Subnet for nodes that all the cluster nodes will be combined to: create a new private subnet and enter CIDR (a router will automatically be created with the subnet) or select an existing subnet in the same pool.
-
Click the necessary checkboxes to configure Automation: node auto-repairing, patch version auto-upgrade; select the maintenance window.
Please note that if the cluster has only one working node, then node auto-repairing and Kubernetes patch version auto-update are not available.
-
Add the SSH-key to have Access to the nodes. You don’t need to upload an SSH-key to create a cluster.
-
Check the final cost and click Create.
Creating a cluster takes several minutes. When creating, the cluster’s status is PENDING_CREATE. As soon as the cluster status changes to ACTIVE, it is ready to run.
Creating Clusters through Terraform
Using Terraform, you can:
- create a project with one Kubernetes cluster and one group of nodes — an example on GitHub;
- create a cluster in an existing project — an example on GitHub.