排空节点

排空活跃 DC/OS 群集中的代理节点

您可以从活跃 DC/OS™ 群集中的代理节点排空任务,以便取下节点以进行维护或从群集中永久移除。节点可以排空,并且其进度可以通过 DC/OS CLI 或 UI 进行监控。

警告:启动排空时,代理节点上运行的所有任务都将被关闭。请谨慎使用此功能!

警告:当指定 -停用 选项时,节点上的所有本地持久数据将丢失!

启动排空导致目标代理节点上的所有任务立即收到关闭事件(假设代理节点目前可以访问)。如果代理节点无法访问,关闭事件的启动将被延迟,直到代理节点可再次被管理节点访问。当任务收到关闭事件时,将向任务发送一个 SIGTERM 信号以开始关闭进程。根据具体任务的行为,此信号可能足以将其终止。某些任务可能使用此信号来开始优雅终止的过程,这可能需要一些时间。延迟后,SIGKILL 信号将发送至任务,它会在任务仍运行时强行将其终止。SIGTERM 和 SIGKILL 信号之间的延迟取决于该任务的结束宽限期长短。如果没有为任务设置宽限期,将根据配置使用默认的数秒值。

先决条件:

最大宽限期

您可以在排空时设置最大宽限期,它可对关闭宽限期的持续时间设置上限。进行此项设置时,在关闭任务时将使用最小的任务宽限期和最大宽限期。

排空后停用代理节点

某些情况下,例如随后缩小的自动缩放云实例,在节点排空并取下之后,它永远不会再回来。每个代理节点都由其硬盘上的元数据唯一性标识,即使未来会扩展其他实例,如果它们不保留上一个实例的持续元数据,则会被 DC/OS 群集视为新节点。

如果唯一代理节点在从群集中排空并移除之后不会返回,您可以指定一个选项,该选项将在完成排空后自动停用节点,这将从群集中删除代理节点的元数据。如果未指定此选项,群集将记住代理节点,以防它以后重新注册到群集中。

使用 CLI 排空

要通过 DC/OS CLI 排空一个节点,首先应在下列命令输出的 ID 列找到该节点的 Apache® Mesos® 代理节点 ID:

dcos node list

然后结合 dcos node drain 命令使用该 ID:

dcos node drain <mesos-agent-id>

可以指定最大宽限期和/或停用选项,类似于该示例:

dcos node drain <mesos-agent-id> --max-grace-period=10m --decommission

在代理节点开始排空后,您便可以通过运行以下命令来监控该节点上的任务:

dcos task list --agent-id=<mesos-agent-id>

您可以使用以下命令来监控节点上排空的总体进度:

dcos node list --mesos-id=<mesos-agent-id>

找到 STATUS 字段:节点的常规状态是 ACTIVE。在节点上启动排空时,它将变为 DRAINING。在所有任务关闭且终端状态更新已由相关服务确认后,并且节点上的所有资源操作都完成后,它将变为 DRAINED。当节点处于 DRAINED 状态时,排空完成。

如果 --decommission 选项包含在初始排空命令中,则在排空完成时,节点的元数据将自动从群集中移除。

重要信息:停用节点还会导致该节点上的所有本地持久数据丢失。

如果未指定停用选项,在任何计划内维护或其他更新程序完成后,群集将等待节点被手动重新激活。

在执行维护前,应停止节点上的 dcos-mesos-slave systemd 单元(或 dcos-mesos-slave-public 对于公共代理),使代理节点不再尝试向管理节点注册:

systemctl stop dcos-mesos-slave

维护后重新激活代理节点

维护完成后,您已准备好重新激活节点并允许其重新加入群集时,可以使用以下命令完成此操作:

dcos node reactivate <mesos-agent-id>

在节点上执行以下命令,启动 dcos-mesos-slave systemd 单元(或 dcos-mesos-slave-public 对于公共代理),代理将重新加入群集:

systemctl start dcos-mesos-slave

通过 UI 监控排空情况

还可以使用 DC/OS UI 来监控代理节点的排空情况。要这样做,请导航到 Nodes“概览”窗格。Status 列将列出 ActiveDrainingDrained,与 CLI 的 node list 命令输出相似。

关于节点排空的注释

排空在代理节点上启动后将无法取消。应谨慎使用此命令,尤其是通过 --decommission 选项执行时,因为这会导致在排空完成后,节点永久从群集中移除。

如果某个节点卡在 DRAINING 状态并且在经过预计持续时间(--max-grace-period 自变量中规定的持续时间,或节点上运行的任务的最长关闭宽限期)之后未过渡到 DRAINED,则应检查节点以确定原因。节点处于 DRAINING 状态后,无需再次发出 dcos node drain 命令。重复该命令将无效。如果节点上的所有任务都已终止,则可能相关服务尚未确认终端任务状态更新,或者该节点上的资源操作未完成。为排除前者,应检查在节点上运行任务的相关服务,并确保它们正在运行且可用。您可以列出节点上的任务,以确定哪些服务可能尚未确认其终端更新:

dcos task list --agent-id=<mesos-agent-id>

为排除后者,可在代理节点上使用 GET_OPERATIONS 调用,以检查当前未完成的资源操作。如果资源操作仍处于 Pending 状态,则该操作可能长时间运行,需要一些时间来完成,或者由于实际执行该操作的存储后端存在某些问题而会被卡住。

手动排空代理节点

虽然上述自动排空程序很可能适用于大多数使用情形,但是当需要对排空过程有更大控制时,也可以手动排空节点。为此,首先取消激活该节点:

dcos node deactivate <mesos-agent-id>

这将停止在该代理节点上启动任何新工作负载。此时,个别服务公开的 API 可用于关闭节点上运行的任何任务。例如,对于通过 DC/OS UI 启动的典型应用程序和 pod,Marathon 容器编排器的 API 可用于终止相关任务。关闭节点上的所有任务后,可以取下节点进行维护,然后在维护完成后再重新激活:

dcos node reactivate <mesos-agent-id>

DC/OS 控制台中的排空

要排空节点,使用 DC/OS 基于 Web 的控制台:

  1. 打开网页浏览器并使用管理用户名和密码登录。

  2. 单击“节点”显示关于代理节点的信息。

  3. 向右滚动以显示要排空的活动节点的操作菜单。

  4. 单击“排空”,将显示一个对话框。

    最大宽限期可在排空对话框中指定。这表示任务正常终止所允许的最长时间,并覆盖默认值数秒。

Draining or deactivating a node

节点概述中的状态列将更改以反映节点的维护状态。

停用节点

排空节点时,在排空完成后,您可以选择 停用 它。

重要信息:如果在排空时启用了“停用”选项,节点将全部从节点概览表中删除,并且无法重新加入群集。

停用/重新激活节点以进行手动排空

也可以使用操作菜单 停用节点 以进行手动排空。当维护完成且已准备好重新激活该节点并允许其重新加入群集时,请从菜单中单击“重新激活”操作:

Reactivating a node