Question: How to Delete a Vultr Kubernetes Engine Cluster
Deleting a Vultr Kubernetes Engine (VKE) cluster involves completely removing your VKE cluster's infrastructure, including the control plane, worker nodes, and all associated resources. This process is final and should be performed carefully. VKE cluster provides a simple method to ensure the thorough and efficient deletion of your VKE cluster when it's no longer required.
Follow this guide delete a Vultr Kubernetes Engine cluster from your Vultr account using the Vultr Customer Portal, API, CLI, or Terraform.
Vultr Customer Portal
1.Navigate to Products and click Kubernetes.
2.Click your target VKE cluster to open its management page.
3.Click the delete icon in the top right of the management page.
4.Check the Destroy VKE Cluster box in the confirmation prompt, and click Destroy VKE Cluster to permanently delete the target VKE cluster.
Vultr API
1.Send a GET request to the List all Kubernetes Clusters endpoint and note the target VKE cluster's ID.
[color=blue]console[/color]
$ curl "https://api.vultr.com/v2/kubernetes/clusters" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
2.Send a DELETE request to the Delete Kubernetes Cluster endpoint to delete the target VKE cluster.
[color=blue]console[/color]
$ curl "https://api.vultr.com/v2/kubernetes/clusters/{cluster-id}" \
-X DELETE \
-H "Authorization: Bearer ${VULTR_API_KEY}"
3.Send a DELETE request to the Delete VKE Cluster and All Related Resources endpoint to delete the target VKE cluster along with all linked resources.
[color=blue]console[/color]
$ curl "https://api.vultr.com/v2/kubernetes/clusters/{cluster-id}/delete-with-linked-resources" \
-X DELETE \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Vultr CLI
1.List the available VKE clusters and note the target VKE cluster's ID.
[color=blue]console[/color]
$ vultr-cli kubernetes list --summarize
2.Delete the target VKE cluster.
[color=blue]console
[/color]
$ vultr-cli kubernetes delete <cluster-id>
3.Delete the target VKE cluster along with all linked resources.
[color=blue]console[/color]
$ vultr-cli kubernetes delete --delete-resources <cluster-id>
Terraform
1.Open your Terraform configuration where the VKE cluster is defined.
2.Remove the vultr_kubernetes resource block, or destroy it by target.
[color=blue]terraform
[/color]
resource "vultr_kubernetes" "vke" {
# ...existing fields (label, region, version, node_pools)
}
# To delete, either remove this block from configuration
# or run: terraform destroy -target vultr_kubernetes.vke
3.Apply the configuration and observe the following output:
Apply complete! Resources: 0 added, 0 changed, 1 destroyed.