How to Enable High Availability

To update a Kubernetes cluster via the command-line, follow these steps:

1. Install doctl, the DigitalOcean command-line tool.

2. Create a personal access token, and save it for use with doctl.

3. Use the token to grant doctl access to your DigitalOcean account.

                 doctl auth init
               

4. Finally, update a Kubernetes cluster with doctl kubernetes cluster update. The basic usage looks like this, but you'll want to read the usage docs for more details:

                 doctl kubernetes cluster update <id|name> [flags]
               

   The following example updates a cluster named example-cluster to enable automatic upgrades and sets the maintenance window to `saturday=02

                     00`
                   

To update a Kubernetes cluster using the DigitalOcean API, follow these steps:

1. Create a personal access token, and save it for use with the API.

2. Send a PUT request to https://api.digitalocean.com/v2/kubernetes/clusters/{cluster_id}

   cURL

   To update a Kubernetes cluster with cURL, call:

   
                   curl -X PUT \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
     -d '{"name": "stage-cluster-01", "tags":["staging", "web-team"]}' \
     "https://api.digitalocean.com/v2/kubernetes/clusters/bd5f5959-5e1e-4205-a714-a914373942af"

   Go

   Go developers can use Godo, the official DigitalOcean V2 API client for Go. To update a Kubernetes cluster with Godo, use the following code:

   
                   import (
       "context"
       "os"
   
       "github.com/digitalocean/godo"
   )
   
   func main() {
       token := os.Getenv("DIGITALOCEAN_TOKEN")
   
       client := godo.NewFromToken(token)
       ctx := context.TODO()
   
       updateRequest := &godo.KubernetesClusterUpdateRequest{
           Name: "stage-cluster-01",
           Tags: []string{"staging", "web-team"},
       }
   
       cluster, _, err := client.Kubernetes.Update(ctx, "bd5f5959-5e1e-4205-a714-a914373942af", updateRequest)
   }

   Ruby

   Ruby developers can use DropletKit, the official DigitalOcean V2 API client for Ruby. To update a Kubernetes cluster with DropletKit, use the following code:

   
                   require 'droplet_kit'
   token = ENV['DIGITALOCEAN_TOKEN']
   client = DropletKit::Client.new(access_token: token)
   
   cluster = DropletKit::KubernetesCluster.new(
     name: 'foo',
     tags: ['staging', 'web-team']
   )
   
   client.kubernetes_clusters.update(cluster, id: 'bd5f5959-5e1e-4205-a714-a914373942af')

   Python

   
                   import os
   from pydo import Client
   
   client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
   
   req = {
     "name": "prod-cluster-01",
     "tags": [
       "k8s",
       "k8s:bd5f5959-5e1e-4205-a714-a914373942af",
       "production",
       "web-team"
     ],
     "maintenance_policy": {
       "start_time": "12:00",
       "day": "any"
     },
     "auto_upgrade": True,
     "surge_upgrade": True,
     "ha": True
   }
   
   resp = client.kubernetes.update_cluster(cluster_id="1fd32a", body=req)

DigitalOcean Kubernetes clusters originally created with version 1.20 or older have a version of the control plane which does not allow you to enable high availability. If you cannot find this card, upgrade your control plane.

To check whether you can upgrade your cluster to the new control plane, see Upgrading to New Control Plane.