Delete Cluster

Deleting a KubeRaya cluster is a destructive and irreversible operation.

This action permanently removes the cluster and its underlying infrastructure from CloudRaya.

Once deleted, the cluster cannot be recovered.

This page explains what happens when you delete a cluster, what is affected, and what you should verify before proceeding.

Only delete a cluster when you are certain it is no longer needed.

What Will Be Deleted

When you delete a KubeRaya cluster, the following components are permanently removed:

Kubernetes Infrastructure

• Kubernetes control plane (master node)
• All worker nodes
• Cluster networking configuration
• Cluster internal DNS and service discovery

Kubernetes Resources

• Pods
• Deployments
• StatefulSets
• Services
• Ingress resources
• ConfigMaps
• Secrets

Cluster Access

• kubeconfig credentials
• API server endpoint
• Dashboard access
• Lens or other third-party tool connections

All cluster-scoped and namespace-scoped resources are deleted.

What Will Not Be Deleted

The following items are not automatically removed when deleting a cluster:

• External domains or DNS records
• External services integrated with the cluster
• Container images stored in external registries
• Application source code or CI/CD pipelines
• Backups stored outside the cluster (if any)

You are responsible for cleaning up any external dependencies.

Irreversibility Notice

Once a cluster is deleted:

• The cluster cannot be restored
• All workloads and data inside the cluster are lost
• The cluster name becomes available for reuse
• Billing for the cluster stops immediately after deletion

There is no undo option.

Confirmation Requirement

To prevent accidental deletion, CloudRaya requires explicit confirmation.

Deletion Confirmation Steps

1. Open the cluster detail page
2. Click Delete Cluster
3. Review the warning message
4. Type the exact cluster name into the confirmation field
5. Click Delete Cluster to proceed

Deletion will only proceed if the cluster name is entered correctly.

When Should You Delete a Cluster?

Delete a cluster when:

• The environment is no longer needed (e.g. test or staging)
• You are rebuilding infrastructure from scratch
• All required data has been backed up
• No production workloads depend on the cluster

Do not delete a cluster if:

• It is running active production workloads
• Required data has not been backed up
• External systems still depend on the cluster

Best Practices Before Deleting

Before deleting a cluster, CloudRaya strongly recommends:

• Verifying all workloads are stopped
• Backing up critical data
• Removing DNS records pointing to the cluster
• Confirming with relevant stakeholders
• Ensuring no automation or CI/CD pipelines depend on the cluster

Treat cluster deletion as a final infrastructure action, not a routine operation.

Related Guides

📄 Manage KubeRaya Clusters

📄 Scale KubeRaya Worker Nodes

📄 Access a KubeRaya Cluster

📄 Kubernetes Best Practices