docker swarm英文文档学习-7-在集群中管理节点

Manage nodes in a swarm在集群中管理节点

List nodes列举节点

为了查看集群中的节点列表，可以在管理节点中运行docker node ls：

$ docker node ls

ID                           HOSTNAME  STATUS  AVAILABILITY  MANAGER STATUS
46aqrk4e473hjbt745z53cr3t    node-    Ready   Active        Reachable
61pi3d91s0w3b90ijw3deeb2q    node-    Ready   Active        Reachable
a5b2m3oghd48m8eu391pefq5u    node-    Ready   Active
e7p8btxeu3ioshyuj6lxiv6g0    node-    Ready   Active
ehkv3bcimagdese79dn78otj5 *  node-    Ready   Active        Leader

AVAILABILITY显示调度程序是否可以向节点分配任务:

• Active意味着调度程序可以将任务分配给节点。
• Pause意味着调度程序不会向节点分配新任务，但现有任务仍在运行。
• Drain意味着调度程序不会向节点分配新任务。调度器关闭所有现有任务，并在可用节点上调度它们。

MANAGER STATUS列显示了Raft共识中节点的参与情况:
没有值表示不参与集群管理的工作节点。
Leader意味着节点是为集群做出所有集群管理和编配决策的主要管理节点。
Reachable意味着该节点是参与raft共识仲裁的管理节点。如果leader节点不可用，则该节点有资格选举为新的leader。
Unavailable意味着节点是无法与其他管理器通信的管理器。如果一个管理器节点变成Unavailable，你应该将一个新的管理器节点加入到集群中，或者将一个工作节点提升为一个管理器。
有关集群管理的更多信息，请参阅 Swarm administration guide。

Inspect an individual node查看单个节点

你可以在管理器节点上运行docker node inspect <NODE-ID>，以查看单个节点的详细信息。输出默认为JSON格式，但是你可以传递--pretty标志以人类可读的格式打印结果。例如:

$ docker node inspect self --pretty

ID:                     ehkv3bcimagdese79dn78otj5
Hostname:               node-
Joined at:              -- ::44.9910662 + utc
Status:
 State:                 Ready
 Availability:          Active
Manager Status:
 Address:               172.17.0.2:
 Raft Status:           Reachable
 Leader:                Yes
Platform:
 Operating System:      linux
 Architecture:          x86_64
Resources:
 CPUs:
 Memory:                1.954 GiB
Plugins:
  Network:              overlay, host, bridge, overlay, null
  Volume:               local
Engine Version:         1.12.-dev

Update a node更新节点

Change node availability 改变节点可用性（availability）属性

更改节点可用性可让你:
耗尽drain管理器节点，使其仅执行群集管理任务，且不可用于任务分配。
耗尽drain一个节点，以便你可以对其进行维护。
暂停pause一个节点，使它不能接收新任务。
恢复不可用unavailable或暂停paused的节点可用状态。
例如，要更改管理器节点以耗尽Drain可用性:

$ docker node update --availability drain node-

node-

See list nodes for descriptions of the different availability options.

Add or remove label metadata添加或移除标签元数据

节点标签提供了一种灵活的节点组织方法。你还可以在服务约束中使用节点标签。在创建服务时应用约束，以限制调度程序为该服务分配任务的节点。
在管理节点上运行docker node update --label-add，向节点添加标签元数据。--label-add标志支持<key>值或<key>=<value>键值对。
对于要添加的每个节点标签，传递--label-add标记一次:

$ docker node update --label-add foo --label-add bar=baz node-

node-

使用docker节点更新为节点设置的标签仅适用于集群中的节点实体。不要将它们与dockerd的docker守护进程标签混淆。
因此，可以使用节点标签将关键任务限制在满足某些需求的节点上。例如，只在应该运行特殊工作负载的机器上调度，例如满足PCI-SS遵从性的机器。
折衷的工作程序无法折衷这些特殊的工作负载，因为它无法更改节点标签。
然而，引擎标签仍然很有用，因为一些不影响容器安全编排的特性最好以分散的方式设置。例如，引擎可以有一个标签来指示它具有某种类型的磁盘设备，这可能与安全性没有直接关系。这些标签更容易被群编配器“信任”。
有关服务约束的更多信息，请参阅docker service create CLI reference。

Promote or demote a node提升或降级节点

你可以将工作节点提升为manager角色。当管理节点不可用时，或者需要脱机进行维护时，这非常有用。类似地，你可以将manager节点降级为worker角色。

注意:无论你提升或降级节点的原因是什么，你都必须始终维护集群中管理器节点的仲裁。有关更多信息，请参阅Swarm administration guide。

若要提升一个或一组节点，请从管理节点运行docker node promote:

$ docker node promote node- node-

Node node- promoted to a manager in the swarm.
Node node- promoted to a manager in the swarm.

若要降级一个或一组节点，请从管理节点运行docker node demote:

$ docker node demote node- node-

Manager node- demoted in the swarm.
Manager node- demoted in the swarm.

docker node promote和docker node demote 命令分别是docker node update --role manager和docker node update --role worker命令的简易版

Install plugins on swarm nodes在集群节点中安装插件

仅支持Edge :此选项仅在Docker CE Edge 版本中可用。参见 Docker CE Edge。

如果你的swarm服务依赖于一个或多个插件，那么这些插件需要在服务可能部署的每个节点上可用。你可以手动在每个节点上安装插件，或者编写安装脚本。在Docker 17.07及更高版本中，你还可以通过指定PluginSpec而不是ContainerSpec来使用Docker API以类似全局服务的方式部署插件。

注意:目前还没有办法使用Docker CLI或Docker Compose将插件部署到集群中。此外，不可能从私有存储库安装插件。

PluginSpec是由插件开发人员定义的。要将插件添加到所有Docker节点，请使用service/create API，传递在TaskTemplate中定义的PluginSpec JSON。

Leave the swarm离开集群

在一个节点中运行docker swarm leave来将其从集群中移除

比如下面在工作节点中离开集群：

$ docker swarm leave

Node left the swarm.

当节点离开集群时，Docker引擎在集群模式下停止运行。协调器不再向节点调度任务。
如果节点是管理器节点，则会收到关于维护仲裁的警告。若要覆盖警告，请传递--force标志。如果最后一个管理器节点离开集群，那么集群将不可用，需要你采取灾难恢复措施。
有关维护仲裁和灾难恢复的信息，请参阅Swarm administration guide。
在节点离开集群之后，你可以在管理器节点上运行docker node rm命令来从节点列表中删除该节点，如：

$ docker node rm node-