码头工人服务更新

描述

更新服务

API 1.24+  客户端和守护程序API都必须至少为 1.24， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

Swarm此命令与Swarm协调器一起使用。

用法

$ docker service update [OPTIONS] SERVICE

扩展说明

如指定参数所述更新服务。参数与相同docker service create。有关更多信息，请参考那里的描述。

通常，如果对服务所做的更改要求重新创建任务以使其生效，则更新服务只会导致将服务的任务替换为新任务。例如，仅更改 --update-parallelism设置不会重新创建任务，因为单个任务不受此设置的影响。但是，该--force标志将导致无论如何重新创建任务。这可用于执行滚动重启，而无需更改服务参数。

笔记

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

例子

更新服务

$ 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选项添加或删除服务的绑定装载或卷。

以下示例创建一个将test-data卷 安装到的服务/somewhere。下一步将更新服务，以将other-volume 卷也安装到/somewhere-else卷上。最后一步将卸载/somewhere安装点，从而有效地删除test-data卷。每个命令都返回服务名称。

• 该--mount-add标志与--mounton上 的标志具有相同的参数service create。有关详细信息，请参考参考中的“卷和绑定安装” 部分service 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标志可以添加或删除服务的已发布端口。您可以使用docker服务create 参考中讨论的短语法或长语法 。

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

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

添加或删除网络

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

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

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

回滚到服务的先前版本

使用该--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选项添加或删除服务的机密。

以下示例添加一个名为的机密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）

service update支持与 See相同的--isolation标志以供参考。service createservice create

更新工作

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

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

作业无法推出或回滚。用于配置更新或回滚设置的所有标志均不适用于作业模式。

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

上级命令

相关命令