FilesExpand file tree

 master

/

docker_node_update.yaml

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

51 lines (41 loc) · 1.66 KB

 master

/

docker_node_update.yaml

Copy path

Top

File metadata and controls

• Code
• Blame

51 lines (41 loc) · 1.66 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

command: docker node update

short: Update a node

long: Update metadata about a node, such as its availability, labels, or roles.

usage: docker node update [OPTIONS] NODE

pname: docker node

plink: docker_node.yaml

options:

- option: availability

description: Availability of the node (active/pause/drain)

- option: label-add

default_value: '[]'

description: Add or update a node label (key=value)

- option: label-rm

default_value: '[]'

description: Remove a node label if exists

- option: role

description: Role of the node (worker/manager)

examples: |-

### Add label metadata to a node

Add metadata to a swarm node using node labels. You can specify a node label as

a key with an empty value:

``` bash

$ docker node update --label-add foo worker1

```

To add multiple labels to a node, pass the `--label-add` flag for each label:

```bash

$ docker node update --label-add foo --label-add bar worker1

```

When you [create a service](service_create.md),

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:

``` bash

$ 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](https://docs.docker.com/engine/userguide/labels-custom-metadata/#daemon-labels).

For more information about labels, refer to [apply custom

metadata](https://docs.docker.com/engine/userguide/labels-custom-metadata/).