码头服务更新

Swarm 此命令与 Swarm 协调器配合使用。

描述

按照指定参数的描述更新服务。参数与 相同 docker service create。请参阅那里的描述以获取更多信息。

通常，如果对服务的更改需要重新创建任务才能生效，则更新服务只会导致服务的任务被新任务替换。例如，仅更改 --update-parallelism设置不会重新创建任务，因为各个任务不受此设置的影响。然而，该--force标志无论如何都会导致任务被重新创建。这可用于执行滚动重新启动，而无需更改服务参数。

笔记

这是集群管理命令，必须在 swarm manager 节点上执行。要了解管理器和工作器，请参阅 文档中的Swarm 模式部分。

选项

例子

更新服务

$ 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-data卷安装到 的 服务/somewhere。下一步更新服务以将other-volume 卷安装到/somewhere-else卷，最后一步卸载/somewhere安装点，从而有效地删除test-data卷。每个命令都会返回服务名称。

• 该标志采用与上的标志 --mount-add相同的参数。有关详细信息，请参阅 参考中的卷和绑定安装 部分。--mountservice createservice create

• 旗帜--mount-rm采用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标志添加或删除服务的已发布端口。您可以使用docker service create参考中讨论的短语法或长语法 。

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

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

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

使用--network-add或--network-rm标志添加或删除服务的网络。您可以使用docker service create参考中讨论的短语法或长语法 。

以下示例将新别名添加到已连接到网络 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支持--isolation与service create 参考 相同的标志service create。

更新职位

当服务被创建为作业时，通过将其模式设置为replicated-job或global-job时执行service create，更新它的选项会受到限制。

更新作业会立即停止任何正在进行的任务。该操作为作业创建一组新的任务并有效地重置其完成状态。如果更新之前有任何任务正在运行，它们将被停止，并创建新任务。

作业无法推出或回滚。用于配置更新或回滚设置的标志对于作业模式均无效。

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