docker node update
| Description | Update a node |
|---|---|
| Usage | docker node update [OPTIONS] NODE |
Swarm This command works with the Swarm orchestrator.
Description
Update metadata about a node, such as its availability, labels, or roles.
NoteThis is a cluster management command, and must be executed on a swarm manager node. To learn about managers and workers, refer to the Swarm mode section in the documentation.
Options
| Option | Default | Description |
|---|---|---|
--availability | Availability of the node (active, pause, drain) | |
--label-add | Add or update a node label (key=value) | |
--label-rm | Remove a node label if exists | |
--role | Role of the node (worker, manager) |
Examples
Add label metadata to a node (--label-add)
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 worker1To 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 worker1The 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.

Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.
