DigitalOcean Kubernetes (DOKS) is a managed Kubernetes service that lets you deploy Kubernetes clusters without the complexities of handling the control plane and containerized infrastructure. Clusters are compatible with standard Kubernetes toolchains and integrate natively with DigitalOcean Load Balancers and block storage volumes.
DigitalOcean’s Managed Kubernetes provides users with administrator access to the cluster and full access to the Kubernetes API through
doctl. There are no restrictions on the API objects users can create as long as the underlying Kubernetes version supports the object(s).
We simplify the Kubernetes experience by managing key services and settings on your behalf that you cannot or should not modify.
You can add more workers and recycle them in the control panel by using the API
doctl. Once you’ve added them, we manage their configuration, including
While it is technically possible to access and alter the worker nodes at this time, your changes will be overwritten by the reconciler and will not persist. In the future, you may not be able to change them at all.
DigitalOcean will apply the following labels to nodes, and their presence is enforced by the reconciler:
doks.digitalocean.com/node-pool doks.digitalocean.com/node-id doks.digitalocean.com/node-pool-id doks.digitalocean.com/version
Custom node pool labels can be set through the DigitalOcean API.
When you create a cluster on version 1.19 or later, we automatically provision two cloud firewalls for the cluster and manage the opening and closing of their NodePorts (ports 30000-32767) as services are added and removed from the cluster. One firewall manages the connections between resources in your VPC network, including the control plane, and worker nodes, while the other manages connections between worker nodes and the public internet. Cluster firewalls are named
k8s- concatenated with the cluster name.
NodePort service in your service spec automatically opens the specified ports on the firewall. When you remove services from the cluster, the ports on the firewall close automatically.
You cannot delete the cluster’s default firewalls or manually change their configuration in the control panel. Any changes made to the default firewalls through the control panel will not persist and be reverted. If you need to open ports outside of the NodePort range, such as port 80, manually create a new DigitalOcean Cloud Firewall and associate it with the cluster.
In some cases, firewall management for a particular service may not be desirable, such as when you want a NodePort to be only accessible using the VPC network. To selectively exclude a service from firewall management, use the
kubernetes.digitalocean.com/firewall-managed annotation and set it to
false. When set to
false, this disables public access to the NodePort and no inbound rules are created.
Load balancers access the cluster using the cluster’s private network interface and don’t need a port explicitly provisioned for them.
Some DigitalOcean products integrate natively with Kubernetes clusters directly from the Kubernetes manifest files, and we manage their integration with the cluster:
You can add DigitalOcean block storage volumes by creating a PersistentVolumeClaim as part of your deployment.
You can add a DigitalOcean Load Balancer by adding a
LoadBalancer service type to your deployment.
You should not manage these DigitalOcean resources through the control panel or API because any changes you make to Kubernetes clusters outside the cluster’s configuration will be overwritten by the DOKS reconciler. For example, if you manually delete a block storage volume or load balancer in a Kubernetes cluster from the control panel, it will be recreated during the next reconciliation process and you will still be billed.
Kubernetes control plane is fully managed and is included in the price of the worker nodes. You cannot modify:
The default admission controllers are available and detailed in the Kubernetes documentation: