mirror of https://github.com/docker/docs.git
70 lines
2.2 KiB
YAML
70 lines
2.2 KiB
YAML
command: docker swarm leave
|
|
short: Leave the swarm
|
|
long: |-
|
|
When you run this command on a worker, that worker leaves the swarm.
|
|
|
|
You can use the `--force` option on a manager to remove it from the swarm.
|
|
However, this does not reconfigure the swarm to ensure that there are enough
|
|
managers to maintain a quorum in the swarm. The safe way to remove a manager
|
|
from a swarm is to demote it to a worker and then direct it to leave the quorum
|
|
without using `--force`. Only use `--force` in situations where the swarm will
|
|
no longer be used after the manager leaves, such as in a single-node swarm.
|
|
usage: docker swarm leave [OPTIONS]
|
|
pname: docker swarm
|
|
plink: docker_swarm.yaml
|
|
options:
|
|
- option: force
|
|
shorthand: f
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Force this node to leave the swarm, ignoring warnings
|
|
deprecated: false
|
|
hidden: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
inherited_options:
|
|
- option: help
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Print usage
|
|
deprecated: false
|
|
hidden: true
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
Consider the following swarm, as seen from the manager:
|
|
|
|
```console
|
|
$ docker node ls
|
|
|
|
ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS
|
|
7ln70fl22uw2dvjn2ft53m3q5 worker2 Ready Active
|
|
dkp8vy1dq1kxleu9g4u78tlag worker1 Ready Active
|
|
dvfxp4zseq4s0rih1selh0d20 * manager1 Ready Active Leader
|
|
```
|
|
|
|
To remove `worker2`, issue the following command from `worker2` itself:
|
|
|
|
```console
|
|
$ docker swarm leave
|
|
|
|
Node left the default swarm.
|
|
```
|
|
|
|
The node will still appear in the node list, and marked as `down`. It no longer
|
|
affects swarm operation, but a long list of `down` nodes can clutter the node
|
|
list. To remove an inactive node from the list, use the [`node rm`](/reference/cli/docker/node/rm/)
|
|
command.
|
|
deprecated: false
|
|
hidden: false
|
|
min_api_version: "1.24"
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: true
|
|
|