Usage: docker node update [OPTIONS] NODE Update a node Options: --availability string Availability of the node (active/pause/drain) --help Print usage --label-add value Add or update a node label (key=value) (default []) --label-rm value Remove a node label if exists (default []) --role string Role of the node (worker/manager)
Add metadata to a swarm node using node labels. You can specify a node label as a key with an empty value:
$ docker node update --label-add foo worker1
To add multiple labels to a node, pass the --label-add
flag for each label:
$ docker node update --label-add foo --label-add bar worker1
When you create a service, you can use node labels as a constraint. A constraint limits the nodes where the scheduler deploys tasks for a service.
For example, to add a type
label to identify nodes where the scheduler should deploy message queue service tasks:
$ docker node update --label-add type=queue worker1
The labels you set for nodes using docker node update
apply only to the node entity within the swarm. Do not confuse them with the docker daemon labels for dockerd.
For more information about labels, refer to apply custom metadata.