docker swarm英文文档学习-7-在集群中管理节点
Manage nodes in a swarm在集群中管理节点
List nodes列举节点
为了查看集群中的节点列表,可以在管理节点中运行docker node ls:
$ docker node ls ID HOSTNAME STATUS AVAILABILITY MANAGER STATUS 46aqrk4e473hjbt745z53cr3t node-5 Ready Active Reachable 61pi3d91s0w3b90ijw3deeb2q node-4 Ready Active Reachable a5b2m3oghd48m8eu391pefq5u node-3 Ready Active e7p8btxeu3ioshyuj6lxiv6g0 node-2 Ready Active ehkv3bcimagdese79dn78otj5 * node-1 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-1 Joined at: 2016-06-16 22:52:44.9910662 +0000 utc Status: State: Ready Availability: Active Manager Status: Address: 172.17.0.2:2377 Raft Status: Reachable Leader: Yes Platform: Operating System: linux Architecture: x86_64 Resources: CPUs: 2 Memory: 1.954 GiB Plugins: Network: overlay, host, bridge, overlay, null Volume: local Engine Version: 1.12.0-dev
Update a node更新节点
Change node availability 改变节点可用性(availability)属性
更改节点可用性可让你:
耗尽drain管理器节点,使其仅执行群集管理任务,且不可用于任务分配。
耗尽drain一个节点,以便你可以对其进行维护。
暂停pause一个节点,使它不能接收新任务。
恢复不可用unavailable或暂停paused的节点可用状态。
例如,要更改管理器节点以耗尽Drain可用性:
$ docker node update --availability drain node-1 node-1
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-1 node-1
使用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-3 node-2 Node node-3 promoted to a manager in the swarm. Node node-2 promoted to a manager in the swarm.
若要降级一个或一组节点,请从管理节点运行docker node demote:
$ docker node demote node-3 node-2 Manager node-3 demoted in the swarm. Manager node-2 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-2