How to Create and Delete Kubernetes Clusters Using the Control Panel

Kubernetes is currently in limited availability, so it may not be visible or available for your account. Learn more.

Create a Cluster

You can create a DigitalOcean Kubernetes Cluster at any time from the Create menu by selecting Clusters. This will take you to the Create a Cluster page.

Once you select Clusters, you’ll have the following choices:

Select a Kubernetes version

The latest stable release is selected by default. Older patch versions of the same minor release are available to support application-specific requirements.

Choose a datacenter region

Choose the region for your cluster. Your cluster master and worker nodes will be located in the same region. If you add a DigitalOcean Load Balancer to your deployment, it will automatically be placed in the same region as the cluster.

If you plan to use DigitalOcean block storage volumes for persistent data storage, choose a region with block storage support.

Add node pool(s)

To create a cluster, you’ll need to add at least one node pool with at least one worker.

Each of the workers in a node pool has identical resources. To take advantage of different resource capacities, you can add additional node pools assign pods to the node pools with the appropriate worker resourcing.

When you create the cluster, billing begins for each worker node as it is created and ends for each worker node as it is destroyed. Additional DigitalOcean resources like block storage volumes or load balancers that are created for the cluster likewise are billed from creation until destruction. By default, three worker nodes are selected because this is the minimum number to ensure high availability. You may wish to decrease to one worker node when you first explore setting up a cluster to keep costs down.

Add your SSH keys

At this time, an SSH key is required to create a cluster. Adding the key prevents the system from enabling password-based authentication and emailing root passwords for each worker nodes. You can SSH to worker nodes from a computer that has the corresponding private key, but in general kubectl exec will provide a more appropriate troubleshooting environment for your application.

Add tags

Clusters are automatically tagged with:

  • k8s
  • The specific cluster ID, like k8s:EXAMPLEc-3515-4a0c-91a3-2452eEXAMPLE
  • The resource type, e.g. k8s:worker

You can also add your own tags to worker nodes in the Tags field.

Choose a name

By default cluster names begin with k8s, followed by the version of kubernetes, the datacenter region, and the cluster ID. At this time, you can rename clusters to something more meaningful to you. That name will also be used in the tag. Please note: currently, you cannot rename a cluster once it has been created.

Create cluster

When you’ve added an SSH key and entered your other setting, create the cluster by clicking the Create Cluster button. It can take several minutes for cluster creation to finish.

Once your cluster is provisioned, use kubectl, the official Kubernetes command-line client, to manage the cluster. See How to Connect to a Digitalocean Kubernetes Cluster with kubectl to get set up.

Delete a Cluster

To delete a cluster, go to the Kubernetes page in the control panel. From the cluster’s More menu, select Manage and then Destroy. You will be prompted to confirm the destruction.

Destroying the cluster will not automatically delete load balancers or block storage volumes. You can delete them manually from the control panel after the cluster is destroyed. Until they are destroyed, you will continue to be billed.