doctl Verified current stable Not installed? Kubernetes

Doctl / Upgrade Kubernetes Cluster

Upgrade Kubernetes Cluster

Upgrades a specified Kubernetes cluster to a target version.

Terminal

doctl k c upgrade <cluster_name>

doctl k c upgrade <cluster_name>

#!/bin/bash

# Upgrade Kubernetes Cluster
doctl {{[k|kubernetes]}} {{[c|cluster]}} upgrade {{cluster_name}}

import subprocess

# Upgrade Kubernetes Cluster
# Make sure to replace <placeholders> with actual values
def run_command():
    cmd = [
        "doctl",
        "k",
        "c",
        "upgrade",
        "<cluster_name>"
    ]
    
    try:
        print(f"Executing: {' '.join(cmd)}")
        subprocess.run(cmd, check=True)
    except subprocess.CalledProcessError as e:
        print(f"Error: {e}")
    except FileNotFoundError:
        print("Error: doctl not found. Please install it first.")

if __name__ == "__main__":
    run_command()

When To Use

During a scheduled maintenance period or when a critical vulnerability is identified in the current version.

Pro Tip

Check the changelog for compatibility issues between versions; some upgrades may require additional configuration changes.

Command Builder

Tune the command before you copy it

Back to syntax

Generated Command

doctl k c upgrade <cluster_name>

Terminal Output

Expected runtime feedback

Simulated preview

Output

Upgrading Kubernetes cluster 'my-cluster'...

+---------------------+---------------------+
| Current Version     | 1.21.5              |
| Upgrade Version     | 1.22.0              |
| Status              | In Progress         |
+---------------------+---------------------+

Upgrade initiated. Please wait for completion...

Anatomy of Output

Understanding the result

Upgrading cluster: my-cluster Progress Indicator

Indicates the cluster that is currently being upgraded.

Successfully upgraded to version 1.22.0 Upgrade Status

Confirmation of successful version upgrade.

Estimated time: 5 minutes Time Estimate

Approximate time to complete the upgrade.

Troubleshooting

Common pitfalls

Error: Upgrade failed due to incompatible configuration.

Solution: Review the compatibility documentation for changes between versions.

Error: Cluster {{cluster_name}} not found.

Solution: Ensure the correct cluster name is used.

Error: Insufficient permissions to upgrade the cluster.

Solution: Ensure the account has the necessary privileges to perform upgrades.

Command Breakdown

What each part is doing

doctl: Base Command; The executable that performs this operation. Here it runs Doctl before the shell applies any redirect operators.
k: k|kubernetes; The value supplied for k|kubernetes.
c: c|cluster; The value supplied for c|cluster.
<cluster_name>: cluster name; The value supplied for cluster name.

How To Run

Execution path

Step 1
Run `doctl kubernetes cluster upgrade my-cluster` to start the upgrade process.
Step 2
Monitor the upgrade status using `doctl kubernetes cluster get my-cluster`.

Alternative Approaches

Comparable commands in other tools

Alternative kubernetes tools for the same job.

Helm / Download Helm Chart Archive helm get <chart_release_name> Kubectl / List Pod Annotations kubectl annotate po <pod_name> --list Kubectl / Print Completion Script Bash Zsh Fish Powershell kubectl completion <bash|zsh|fish|powershell> Kubectl / Edit Pod Default Namespace kubectl edit po/<pod_name> Minikube / Start Minikube In Background Mode minikube start --background