doctl Verified current stable Not installed? Kubernetes

Doctl / Delete Kubernetes Cluster

Delete Kubernetes Cluster

Deletes a specified Kubernetes cluster and its resources.

Terminal

doctl k c d <cluster_name>

doctl k c d <cluster_name>

#!/bin/bash

# Delete Kubernetes Cluster
doctl {{[k|kubernetes]}} {{[c|cluster]}} {{[d|delete]}} {{cluster_name}}

import subprocess

# Delete Kubernetes Cluster
# Make sure to replace <placeholders> with actual values
def run_command():
    cmd = [
        "doctl",
        "k",
        "c",
        "d",
        "<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

When decommissioning a cluster that's no longer in use to prevent unnecessary resource charges.

Pro Tip

Use the `--wait` flag to block until deletion is confirmed, ensuring no orphaned resources remain.

Warning

Destructive operation. Confirm the target path and keep a backup before executing.

Command Builder

Tune the command before you copy it

Back to syntax

Generated Command

doctl k c d <cluster_name>

Terminal Output

Expected runtime feedback

Simulated preview

Output

$ doctl kubernetes cluster delete my-cluster

Deleting Kubernetes cluster 'my-cluster'...

ID          Name         Region       Version
------------------------------------------------
12345678    my-cluster   nyc1         1.21.5

Cluster 'my-cluster' deleted successfully.

Anatomy of Output

Understanding the result

Deleting cluster: my-cluster Progress Notification

Indicates which cluster is currently being deleted.

Deletion status: In Progress Status Update

Current status of the deletion process.

Cluster my-cluster deleted successfully Completion Confirmation

Final confirmation of successful deletion.

Troubleshooting

Common pitfalls

Error: Cluster {{cluster_name}} not found.

Solution: Verify the name is correct and exists.

Error: Cluster is in a state that cannot be deleted.

Solution: Check the cluster status; it must be in a running state.

Error: You do not have permission to delete this cluster.

Solution: Check user privileges and DigitalOcean account settings.

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.
d: d|delete; The value supplied for d|delete.
<cluster_name>: cluster name; The value supplied for cluster name.

How To Run

Execution path

Step 1
Run `doctl kubernetes cluster list` to find the cluster name.
Step 2
Execute `doctl kubernetes cluster delete <cluster_name>` to delete the 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