Deleting an OKE Node Pool Node
Learn how to explicitly delete an OKE worker node on Compute Cloud@Customer.
Worker nodes are also deleted when you update a node pool to scale down the node pool or change the subnet or fault domains of the node pool. See Updating an OKE Node Pool.
Deleting a worker node permanently deletes the node. You can't recover a deleted worker node.
When you delete a node, by default a new node is created to satisfy the node count set for the pool. To override this behavior, select the option to decrease node pool size.
Don't use the kubectl delete node command to terminate worker nodes
in an OKE cluster. The kubectl delete
node command removes the worker node from the cluster's etcd key-value
store, but the command doesn't terminate the underlying compute instance.
- In the Compute Cloud@Customer Console navigation menu, click Containers, then click Kubernetes Clusters.
-
Click the name of the cluster that contains the node that you want to delete.
-
On the cluster details page, under Resources, click Node Pools.
-
Click the name of the node pool that contains the node that you want to delete.
-
On the node pool details page, under Resources, click Nodes.
-
For the node that you want to delete, click the Actions menu (
), then click
Delete. -
Confirm the deletion.
-
If you don't want a new node to be automatically created to replace the deleted node, select Decrease node pool size.
-
Check the box to override the eviction grace duration in the cordon and drain settings for the node. See the description of this field in Updating an OKE Node Pool.
Use the arrows to decrease or increase the number of minutes of eviction grace duration.
You can't clear "Force terminate after grace period." The node is deleted after its pods are evicted or at the end of the eviction grace duration, even if not all pods are evicted.
For descriptions of cordon and drain and eviction grace duration, go to Creating an OKE Worker Node Pool, click the CLI tab, and see Node and node pool deletion settings.
-
Click Delete.
-
Use the oci ce node-pool delete-node command and required parameters to delete a node pool node.
oci ce node-pool delete-node --node-id <node_OCID> --node-pool-id <node-pool_OCID> [OPTIONS]-
Get the information you need to run the command.
-
OCID of the node pool:
oci ce node-pool list -
OCID of the node:
oci ce node-pool list
-
-
Run the delete node pool node command.
If you don't want a new node to be automatically created to replace the deleted node, specify the
--is-decrement-sizeoption.Example:
$ oci ce node-pool delete-node --node-pool-id ocid1.nodepool.unique_ID \ --node-id ocid1.instance.unique_ID --is-decrement-size true --forceYou can use the
--override-eviction-grace-durationoption to set a new value forevictionGraceDurationfor this node deletion. See the description of--node-eviction-node-pool-settingsin Creating an OKE Worker Node Pool. Fornode-pool delete-node, this new eviction grace duration value only applies to the node being deleted.
For a complete list of CLI commands, flags, and options, see the Command Line Reference.
-
Use the DeleteNode operation to delete a node pool node.
For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.