Alauda Container Platform

Deleting/Removing Namespaces

You can either delete a namespace permanently or remove it from the current project.

TOC

Deleting NamespacesRemoving NamespacesHow to choose between remove and deleteRemoving or deleting namespaces by using new web consoleRemove from the Applications viewDelete from the Clusters view

Deleting Namespaces

Delete Namespace: Permanently deletes a namespace and all resources within it (e.g., Pods, Services, ConfigMaps). This action cannot be undone and releases allocated resource quotas.

kubectl delete namespace <namespace-name>

Removing Namespaces

Remove Namespace: Removing a namespace from the current project without deleting its resources. The namespace remains in the cluster and can be imported into other projects via Import Namespace.

NOTE
  • This feature is exclusive to the .
  • Kubernetes does not natively support "removing" namespaces from projects.
kubectl label namespace <namespace-name> cpaas.io/project- --overwrite

How to choose between remove and delete

Use Remove Namespace when the namespace resource should remain in the cluster but should no longer belong to the current project.

Use Delete Namespace when the namespace resource itself is no longer needed and the workloads and namespaced resources inside it can be removed.

Before deleting a namespace, verify that workloads, ConfigMaps, Secrets, storage usage, and any remaining troubleshooting needs are no longer required in that namespace.

Removing or deleting namespaces by using new web console

This page mainly describes the legacy console workflow, but namespace removal or deletion in the new web console can start from different views.

Remove from the Applications view

Use the Applications view when you need to remove the namespace from the current project without necessarily deleting the namespace resource itself.

Entry path and action order:

  • Open the current project, then go to Applications > Namespaces.
  • Open the target namespace or use its Actions menu.
  • Choose Remove Namespace when the intent is to end project association while keeping the namespace resource in the cluster.
  • Choose Delete Namespace only when the namespace resource itself must be deleted and the environment exposes that action in the current view.

Delete from the Clusters view

Use the Clusters view when you need to delete the namespace resource from a concrete cluster.

Entry path and action order:

  • Open the target cluster first.
  • Go to Namespaces in that cluster context and select the target namespace.
  • Choose Delete Namespace from the available action entry and confirm the deletion.