docs: add delete node pool section (#5569) (#5603)

* docs: add delete node pool section * Apply suggestions from code review * docs: remove reconfigure page * docs: improve deletion warning --------- Co-authored-by: Adelina Simion <[email protected]>
spectrocloud · Jan 30, 2025 · 2d69476 · 2d69476
1 parent 98b2e9a
commit 2d69476
Show file tree

Hide file tree

Showing 4 changed files with 53 additions and 65 deletions.
diff --git a/docs/docs-content/clusters/cluster-management/cluster-management.md b/docs/docs-content/clusters/cluster-management/cluster-management.md
@@ -15,9 +15,9 @@ visibility into the workloads running inside your cluster and cluster costs.
 
 The following sections describe these capabilities in detail:
 
-- [Reconfigure](reconfigure.md) - Scale your clusters up/down by adding/reducing the number of nodes in a node pool and
+- [Node Pools](node-pool.md) - Scale your clusters up/down by adding/reducing the number of nodes in a node pool and
   adding additional worker pools. Resize nodes in a node pool by modifying the node specs (CPU, Memory, or Instance Type
-  for public clouds). Add additional fault domains such as availability zones to a node pool.
+  for public clouds).
 
 - [Updates](cluster-updates.md) - Upgrade core packs (OS, Kubernetes, CSI, CNI) and add-on layers, such as Monitoring
   and Security.

diff --git a/docs/docs-content/clusters/cluster-management/node-pool.md b/docs/docs-content/clusters/cluster-management/node-pool.md
@@ -3,6 +3,7 @@ sidebar_label: "Node Pools"
 title: "Node Pools"
 description: "Learn about the node pools and applying changes to a node pool."
 hide_table_of_contents: false
+toc_max_heading_level: 2
 sidebar_position: 190
 tags: ["clusters", "cluster management"]
 ---
@@ -183,6 +184,52 @@ After you have modified a new node pool, you can validate the node pool by follo
 5. Ensure the new node pool is listed in the **Node Pools** section and that all compute instances are in the healthy
    status.
 
+## Delete a Node Pool
+
+You can delete a worker node pool from an active cluster using the following steps.
+
+:::warning
+
+The deletion of a node pool drains and removes its worker nodes. Before proceeding, ensure that your remaining node
+pools have enough resources to take on the workloads from the pool being deleted, to prevent any disruption.
+
+:::
+
+### Prerequisites
+
+- An active cluster in Palette with at least one worker node pool.
+
+- The `cluster.update` permission, which is required to edit clusters.
+
+### Delete Node Pool
+
+1. Log in to [Palette](https://console.spectrocloud.com).
+
+2. From the left **Main Menu**, click **Clusters**.
+
+3. Select the cluster with the node pool you want to delete.
+
+4. Click the **Nodes** tab.
+
+5. Locate the node pool you want to delete and click the **Delete** button.
+
+6. Click **Delete** again to confirm the deletion. This action will drain and delete all nodes in the node pool.
+
+### Validate
+
+Use the following steps to confirm that the node pool was deleted successfully.
+
+1. Log in to [Palette](https://console.spectrocloud.com).
+
+2. From the left **Main Menu**, click on **Clusters**.
+
+3. Select the cluster that had the deleted node pool.
+
+4. Click the **Nodes** tab.
+
+5. Verify that the deleted node pool is no longer listed in the **Node Pools** section and that all the remaining
+   compute instances are in a healthy state.
+
 ## Approve Cluster Repave
 
 ### Prerequisites

diff --git a/docs/docs-content/clusters/cluster-management/reconfigure.md b/docs/docs-content/clusters/cluster-management/reconfigure.md
diff --git a/redirects.js b/redirects.js
@@ -482,6 +482,10 @@ let redirects = [
     from: "/security-bulletins/cve-reports/",
     to: "/security-bulletins/reports/",
   },
+  {
+    from: "/clusters/cluster-management/reconfigure/",
+    to: "/clusters/cluster-management/node-pool/",
+  },
   {
     from: [
       "/integrations/antrea-cni",