1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/reference/commandline/node_rm.md
Diogo Monica a327c231b5 Add --force to node removal
Signed-off-by: Diogo Monica <diogo.monica@gmail.com>
2016-08-01 18:55:58 -07:00

1.3 KiB

node rm

Usage:  docker node rm [OPTIONS] NODE [NODE...]

Remove one or more nodes from the swarm

Aliases:
  rm, remove

Options:
      --force  Force remove an active node
      --help   Print usage

Removes specified nodes from a swarm.

Example output:

$ docker node rm swarm-node-02
Node swarm-node-02 removed from swarm

Removes nodes from the swarm that are in the down state. Attempting to remove an active node will result in an error:

$ docker node rm swarm-node-03
Error response from daemon: rpc error: code = 9 desc = node swarm-node-03 is not down and can't be removed

If a worker node becomes compromised, exhibits unexpected or unwanted behavior, or if you lose access to it so that a clean shutdown is impossible, you can use the force option.

$ docker node rm --force swarm-node-03
Node swarm-node-03 removed from swarm

Note that manager nodes have to be demoted to worker nodes before they can be removed from the cluster.