Chapter 4. Deleting a machine

You can delete a specific machine.

4.1. Deleting a specific machine

You can delete a specific machine.


  • Install an OpenShift Container Platform cluster.
  • Install the OpenShift CLI (oc).
  • Log into oc as a user with cluster-admin permission.


  1. View the Machines that are in the cluster and identify the one to delete:

    $ oc get machine -n openshift-machine-api

    The command output contains a list of Machines in the <clusterid>-worker-<cloud_region> format.

  2. Delete the Machine:

    $ oc delete machine <machine> -n openshift-machine-api

    By default, the machine controller tries to drain the node that is backed by the machine until it succeeds. In some situations, such as with a misconfigured Pod disruption budget, the drain operation might not be able to succeed in preventing the machine from being deleted. You can skip draining the node by annotating "" in a specific machine. If the machine being deleted belongs to a MachineSet, a new machine is immediately created to satisfy the specified number of replicas.