modules/machine-delete.adoc

// Module included in the following assemblies:
//
// * machine_management/delete-machine.adoc

[id="machine-delete_{context}"]
= Deleting a specific machine

You can delete a specific machine.

.Prerequisites

* Install an {product-title} cluster.
* Install the OpenShift CLI (`oc`).
* Log into `oc` as a user with `cluster-admin` permission.

.Procedure

. View the Machines that are in the cluster and identify the one to delete:
+
[source,terminal]
----
$ oc get machine -n openshift-machine-api
----
+
The command output contains a list of Machines in the `<clusterid>-worker-<cloud_region>` format.

. Delete the Machine:
+
[source,terminal]
----
$ oc delete machine <machine> -n openshift-machine-api
----

+
[IMPORTANT]
====
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 "machine.openshift.io/exclude-node-draining" 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.
====
Add machine deletion docs 2019-09-23 10:29:27 +02:00			`// Module included in the following assemblies:`
			`//`
			`// * machine_management/delete-machine.adoc`

			`[id="machine-delete_{context}"]`
			`= Deleting a specific machine`

			`You can delete a specific machine.`

			`.Prerequisites`

			`* Install an {product-title} cluster.`
Updated wording for long oc install prereqs 2020-09-02 16:15:05 -04:00			* Install the OpenShift CLI (`oc`).
Add machine deletion docs 2019-09-23 10:29:27 +02:00			* Log into `oc` as a user with `cluster-admin` permission.

			`.Procedure`

			`. View the Machines that are in the cluster and identify the one to delete:`
			`+`
Code block separation for machine management 2020-08-06 08:31:09 -04:00			`[source,terminal]`
Add machine deletion docs 2019-09-23 10:29:27 +02:00			`----`
			`$ oc get machine -n openshift-machine-api`
			`----`
			`+`
			The command output contains a list of Machines in the `<clusterid>-worker-<cloud_region>` format.

			`. Delete the Machine:`
			`+`
Code block separation for machine management 2020-08-06 08:31:09 -04:00			`[source,terminal]`
Add machine deletion docs 2019-09-23 10:29:27 +02:00			`----`
bug 1801528 correction machine deletion command 2020-02-13 11:05:29 -05:00			`$ oc delete machine <machine> -n openshift-machine-api`
Add machine deletion docs 2019-09-23 10:29:27 +02:00			`----`

			`+`
			`[IMPORTANT]`
			`====`
			`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 "machine.openshift.io/exclude-node-draining" 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.`
			`====`