Docker 服务更新

群此命令适用于 Swarm 编排器。

描述

按照指定参数的说明更新服务。参数包括 与docker service create.请参阅描述 了解更多信息。

通常，如果对 service 需要重新创建任务才能生效。例如，仅将--update-parallelism设置不会重新创建任务，因为各个任务不受此影响 设置。但是，--force标志将导致重新创建任务。这可用于执行 滚动重启，不更改服务参数。

注意

这是一个集群管理命令，必须在 swarm 上执行 Manager 节点。要了解 Manager 和 worker，请参阅 文档。

选项

例子

更新服务

$ docker service update --limit-cpu 2 redis

执行滚动重启，不更改参数

$ docker service update --force --update-parallelism 1 --update-delay 30s redis

在此示例中，--force标志导致服务的任务关闭 并替换为新参数，即使其他参数都不会 通常会导致这种情况发生。这--update-parallelism 1设置确保 一次只替换一个任务（这是默认行为）。这--update-delay 30s设置会在任务之间引入 30 秒的延迟，因此 滚动重启是逐渐发生的。

添加或删除挂载（--mount-add、--mount-rm）

使用--mount-add或--mount-rm选项 添加或删除服务的绑定挂载 或卷。

以下示例创建一个服务，该服务将test-datavolume 设置为/somewhere.下一步将更新服务，以同时挂载other-volumevolume 设置为/somewhere-elsevolume 中，最后一步卸载/somewhere安装 点，有效地删除了test-data卷。每个命令都会返回 服务名称。

• 这--mount-addflag 采用与--mount标记service create.请参阅 卷和绑定挂载 中的部分service create有关详细信息，请参阅。

• 这--mount-rmflag 将target坐骑的路径。

$ docker service create \
    --name=myservice \
    --mount type=volume,source=test-data,target=/somewhere \
    nginx:alpine

myservice

$ docker service update \
    --mount-add type=volume,source=other-volume,target=/somewhere-else \
    myservice

myservice

$ docker service update --mount-rm /somewhere myservice

myservice

添加或删除已发布的服务端口（--publish-add、--publish-rm）

使用--publish-add或--publish-rm用于添加或删除已发布的 port 的服务。您可以使用 docker service create 参考中讨论的 short 或 long 语法。

以下示例将已发布的服务端口添加到现有服务。

$ docker service update \
  --publish-add published=8080,target=80 \
  myservice

添加或删除网络（--network-add、--network-rm）

使用--network-add或--network-rm要为其添加或删除网络的标志 一个服务。您可以使用 docker service create 参考中讨论的 short 或 long 语法。

以下示例将新的别名添加到已连接到 network my-network 的现有服务：

$ docker service update \
  --network-rm my-network \
  --network-add name=my-network,alias=web1 \
  myservice

回滚到服务的上一个版本 （--rollback）

使用--rollback选项回滚到服务的先前版本。

这会将服务恢复到最近一次docker service update命令。

以下示例将服务的副本数从 4 更新为 5，然后回滚到之前的配置。

$ docker service update --replicas=5 web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/5       nginx:alpine

以下示例回滚web服务：

$ docker service update --rollback web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/4       nginx:alpine

其他选项可以与--rollback以及，例如，--update-delay 0s要在任务之间没有延迟地执行回滚：

$ docker service update \
  --rollback \
  --update-delay 0s
  web

web

还可以将服务设置为自动回滚到以前的版本 当更新失败时。要设置自动回滚服务，请使用--update-failure-action=rollback.如果分数 成功更新失败的任务超过了--update-max-failure-ratio.

回滚作的速率、并行度和其他参数为 由使用以下标志传递的值确定：

• --rollback-delay
• --rollback-failure-action
• --rollback-max-failure-ratio
• --rollback-monitor
• --rollback-parallelism

例如，使用--update-parallelism 1 --rollback-parallelism 3在正常更新期间一次更新一个任务，但在回滚期间，3 任务将回滚。这些回滚参数都受到尊重 在自动回滚期间以及使用--rollback.

添加或删除密钥（--secret-add、--secret-rm）

使用--secret-add或--secret-rm选项添加或删除服务的 秘密。

以下示例添加一个名为ssh-2并删除ssh-1:

$ docker service update \
    --secret-add source=ssh-2,target=ssh-2 \
    --secret-rm ssh-1 \
    myservice

使用模板更新服务

的一些标志service update支持使用模板。 看service create以供参考。

在 Windows 上指定隔离模式 （--isolation）

service update支持相同的--isolationflag 设置为service create看service create以供参考。

更新作业

将服务创建为作业时，将其模式设置为replicated-job或 自global-job当做service create，更新选项包括 有限。

更新 Job 会立即停止任何正在进行的 Task。作 为作业创建一组新的 Task 并有效地重置其完成 地位。如果在更新之前有任何 Task 正在运行，则它们将停止，并且新的 任务已创建。

作业无法转出或回滚。没有用于配置的标志 Update 或 Rollback 设置对 Job 模式有效。

要使用与之前运行的相同参数再次运行作业，它可以 强制更新--force旗。