清空 swarm 上的节点

在本教程的前面步骤中，所有节点都以 Active（活跃）可用性状态运行。集群管理器可以将任务分配给任何 Active 节点，因此到目前为止，所有节点都可用于接收任务。

有时，例如在计划维护期间，您需要将节点的可用性设置为 Drain（排空）。Drain 可用性会阻止节点从集群管理器接收新任务。这也意味着管理器会停止在该节点上运行的任务，并在具有 Active 可用性的节点上启动副本任务。

重要

将节点设置为 Drain 不会从该节点移除独立容器，例如使用 docker run、docker compose up 或 Docker 引擎 API 创建的容器。节点的任何状态，包括 Drain，仅影响该节点调度集群服务工作负载的能力。

1. 如果你还没有这样做，请打开一个终端并通过 ssh 连接到你运行管理器节点的机器。例如，本教程使用一台名为 manager1 的机器。

2. 验证您的所有节点是否都处于活跃可用状态。

   $ docker node ls
   
   ID                           HOSTNAME  STATUS  AVAILABILITY  MANAGER STATUS
   1bcef6utixb0l0ca7gxuivsj0    worker2   Ready   Active
   38ciaotwjuritcdtn9npbnkuz    worker1   Ready   Active
   e216jshn25ckzbvmwlnh5jr3g *  manager1  Ready   Active        Leader
   

3. 如果您没有在运行滚动更新教程中的 redis 服务，请立即启动它。

   $ docker service create --replicas 3 --name redis --update-delay 10s redis:7.4.0
   
   c5uo6kdmzpon37mgj9mwglcfw
   

4. 运行 docker service ps redis 查看集群管理器如何将任务分配给不同的节点。

   $ docker service ps redis
   
   NAME                               IMAGE        NODE     DESIRED STATE  CURRENT STATE
   redis.1.7q92v0nr1hcgts2amcjyqg3pq  redis:7.4.0  manager1 Running        Running 26 seconds
   redis.2.7h2l8h3q3wqy5f66hlv9ddmi6  redis:7.4.0  worker1  Running        Running 26 seconds
   redis.3.9bg7cezvedmkgg6c8yzvbhwsd  redis:7.4.0  worker2  Running        Running 26 seconds
   

   在这种情况下，集群管理器将一个任务分配给了每个节点。您可能会看到在您的环境中，任务在节点间的分配有所不同。

5. 运行 docker node update --availability drain <NODE-ID> 来排空一个分配了任务的节点。

   $ docker node update --availability drain worker1
   
   worker1
   

6. 检查该节点以查看其可用性。

   $ docker node inspect --pretty worker1
   
   ID:			38ciaotwjuritcdtn9npbnkuz
   Hostname:		worker1
   Status:
    State:			Ready
    Availability:		Drain
   ...snip...
   

   被排空的节点在 Availability（可用性）一栏显示为 Drain。

7. 运行 docker service ps redis 查看集群管理器如何更新 redis 服务的任务分配。

   $ docker service ps redis
   
   NAME                                    IMAGE        NODE      DESIRED STATE  CURRENT STATE           ERROR
   redis.1.7q92v0nr1hcgts2amcjyqg3pq       redis:7.4.0  manager1  Running        Running 4 minutes
   redis.2.b4hovzed7id8irg1to42egue8       redis:7.4.0  worker2   Running        Running About a minute
    \_ redis.2.7h2l8h3q3wqy5f66hlv9ddmi6   redis:7.4.0  worker1   Shutdown       Shutdown 2 minutes ago
   redis.3.9bg7cezvedmkgg6c8yzvbhwsd       redis:7.4.0  worker2   Running        Running 4 minutes
   

   集群管理器通过结束在 Drain 可用性节点上的任务，并在 Active 可用性节点上创建一个新任务来维持所需状态。

8. 运行 docker node update --availability active <NODE-ID> 将排空的节点恢复到活跃状态。

   $ docker node update --availability active worker1
   
   worker1
   

9. 检查该节点以查看更新后的状态。

   $ docker node inspect --pretty worker1
   
   ID:			38ciaotwjuritcdtn9npbnkuz
   Hostname:		worker1
   Status:
    State:			Ready
    Availability:		Active
   ...snip...
   

   当您将节点设置回 Active 可用性时，它可以接收新任务：

   • 在服务更新以进行扩容时
   • 在滚动更新期间
   • 当您将另一个节点设置为 Drain 可用性时
   • 当另一个活跃节点上的任务失败时

后续步骤

接下来，您将学习如何使用 Swarm 模式的路由网格。