Last modified May 30, 2023
'gsctl delete nodepool' command reference
gsctl and the REST API are being phased out. We recommend to familiarize yourself with our Management API and the kubectl gs plugin as a future-proof replacement. We provide a migration page to help you with the transition.
The gsctl delete nodepool
command deletes a node pool.
Deleting a node pool means that all worker nodes in the pool will be drained, cordoned and then terminated.
In case you are running production workloads on the node pool you want to delete,
make sure that there is at least one other node pool with capacity to
schedule the workloads. Also check whether label selectors, taints and
tolerations will allow scheduling on other pool’s worker nodes. The best
way to observe this is by manually cordoning and draining the pool’s
worker nodes and checking workload’s node assignments, before issuing
the delete nodepool
command.
Note: Data stored outside of persistent volumes will be lost and there is no way to undo this.
Usage
The command is called with the cluster and node pool ID as the only argument, separated by a slash.
Example:
gsctl delete nodepool f01r4/op1dl
Here, f01r4
is the cluster ID and op1dl
is the node pool ID.
You can also use the cluster’s name for identifying the cluster:
gsctl delete nodepool "Cluster name"/op1dl
A confirmation will be required to finally delete the node pool. To suppress this
confirmation, add the --force
option.
Related
gsctl create nodepool
- Add a node pool to a clustergsctl list nodepools
- List all node pools of a clustergsctl show nodepool
- Show details for a node poolgsctl update nodepool
- Modify a node pool
Need help, got feedback?
We listen to your Slack support channel. You can also reach us at support@giantswarm.io. And of course, we welcome your pull requests!