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.