Delete Projects

Delete a Project when its team workspace is no longer needed. When you delete a Project, PaletteAI removes the Project, along with all Project-scoped configurations and resources, such as Compute Configs, integrations, and Compute Pools. The Project's Kubernetes namespace is automatically removed as part of the deletion process.

warning

Project deletion is permanent. The Project namespace and every resource it contains, such as Compute Configs, integrations, Compute Pools, Profile Bundles, App Deployments, and Model Deployments scoped to the Project, is removed and cannot be recovered.

Before you delete a Project, consider whether you want to reuse any of its configuration.

• To duplicate the entire Project, including its Compute Configs, integrations, and other settings, clone the Project from the PaletteAI UI before deletion. From the left main menu, select Projects, locate the Project tile, select the three-dot menu, and choose Clone.

• To move individual resources, such as ComputeConfig resources, into another Project, change the namespace referenced in each resource's manifest to the destination Project's namespace, then re-apply the manifest with kubectl apply --filename <manifest-location> before you delete the source Project. For details, refer to the YAML workflow under Modify Project.

Prerequisites

UI Workflow

• A user with Tenant admin permissions for the Tenant the Project belongs to.

YAML Workflow

• kubectl installed and available in your $PATH.

• The KUBECONFIG environment variable set to the path of the PaletteAI hub cluster's kubeconfig file.

  export KUBECONFIG=<kubeconfig-location>

• A user with Tenant admin or Project admin permissions for the Project. Both roles grant delete on Project resources in the Project's namespace.

Enablement

UI Workflow

1. Log in to the PaletteAI Tenant the Project belongs to.

2. From the Projects Menu in the top-left, select All Projects.

3. From the left main menu, select Projects.

4. Select the three-dot menu beside the applicable Project tile and Delete the Project.

YAML Workflow

Delete the Project by name and namespace. The Project's namespace and all resources within it, including Compute Configs and integrations, are automatically removed as part of the deletion process.

kubectl delete project <project-name> --namespace <project-namespace>

Example Command

kubectl delete project project-docs --namespace project-docs

Alternatively, if you have the Project manifest available, you can delete the Project by referencing the manifest. To export the current manifest before deletion, use kubectl --namespace <project-namespace> get project <project-name> --output yaml > project.yaml.

kubectl delete --filename <project-location>

Example Command

kubectl delete --filename project.yaml

Validate

UI Workflow

1. Log in to the PaletteAI Tenant the Project belongs to.

2. From the Projects Menu in the top-left, select All Projects.

3. From the left main menu, select Projects.

4. Verify the applicable Project tile is no longer available.

YAML Workflow

1. Verify the Project's namespace no longer exists.

   kubectl get namespaces

   Before deletion, the project-docs namespace appears in the list.

   Example Output Before Deletion

   NAME                                    STATUS   AGE
   # ... additional output omitted for readability
   open-cluster-management-hub             Active   21d
   palette-system                          Active   21d
   piraeus-system                          Active   21d
   project-docs                            Active   2d
   spectro-mgmt-plane                      Active   21d
   spectro-system                          Active   21d
   spectro-task-693f654a6dd7fb8a0a2a6e3d   Active   21d
   ui-system                               Active   21d
   zot-system                              Active   21d

   After deletion, the project-docs namespace is no longer listed.

   Example Output After Deletion

   NAME                                    STATUS   AGE
   # ... additional output omitted for readability
   open-cluster-management-hub             Active   21d
   palette-system                          Active   21d
   piraeus-system                          Active   21d
   spectro-mgmt-plane                      Active   21d
   spectro-system                          Active   21d
   spectro-task-693f654a6dd7fb8a0a2a6e3d   Active   21d
   ui-system                               Active   21d
   zot-system                              Active   21d

2. Verify the ComputeConfig, Project, and Settings resources for the deleted Project no longer exist.

   kubectl get computeconfig,projects,settings --all-namespaces

   Before deletion, rows for the project-docs namespace appear alongside the default Project's resources.

   Example Output Before Deletion

   NAMESPACE      NAME                                          AGE
   default        computeconfig.spectrocloud.com/default        21d
   project-docs   computeconfig.spectrocloud.com/default        2d
   
   NAMESPACE      NAME                                          DISPLAYNAME       READY   TENANT    SETTINGS   COMPUTE CONFIG        ROLES CREATED   AGE
   default        project.spectrocloud.com/default              Default Project   true    default              default               true            21d
   project-docs   project.spectrocloud.com/project-docs         Docs Project      true    default              default               true            2d
   
   NAMESPACE      NAME                                          READY   AGE
   default        settings.spectrocloud.com/default             true    21d
   project-docs   settings.spectrocloud.com/default             true    2d

   After deletion, only the default Project's resources remain.

   Example Output After Deletion

   NAMESPACE      NAME                                          AGE
   default        computeconfig.spectrocloud.com/default        21d
   
   NAMESPACE      NAME                                          DISPLAYNAME       READY   TENANT    SETTINGS   COMPUTE CONFIG        ROLES CREATED   AGE
   default        project.spectrocloud.com/default              Default Project   true    default              default               true            21d
   
   NAMESPACE      NAME                                          READY   AGE
   default        settings.spectrocloud.com/default             true    21d