docker node update
| 描述 | 更新节点 |
|---|---|
| 用法 | docker node update [OPTIONS] NODE |
Swarm 此命令适用于 Swarm 编排器。
描述
更新关于节点(如其可用性、标签或角色)的元数据。
注意这是一个集群管理命令,必须在 Swarm 管理器节点上执行。要了解管理器和工作器,请参阅文档中的Swarm 模式部分。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
--availability | 节点的可用性(`active`、`pause`、`drain`) | |
--label-add | 添加或更新节点标签(`key=value`) | |
--label-rm | 如果存在,移除节点标签 | |
--role | 节点的角色(`worker`、`manager`) |
示例
向节点添加标签元数据(--label-add)
使用节点标签向 swarm 节点添加元数据。您可以将节点标签指定为带有空值的键。
$ docker node update --label-add foo worker1要向节点添加多个标签,请为每个标签传递 `--label-add` 标志。
$ docker node update --label-add foo --label-add bar worker1
当您创建服务时,可以使用节点标签作为约束。约束限制了调度器部署服务任务的节点。
例如,添加一个 `type` 标签来标识调度器应部署消息队列服务任务的节点。
$ docker node update --label-add type=queue worker1您使用 `docker node update` 为节点设置的标签仅适用于 swarm 中的节点实体。不要将它们与 dockerd 的 docker 守护程序标签混淆。
有关标签的更多信息,请参阅应用自定义元数据。