docker service update

Swarm 此命令适用于 Swarm 集群管理器。

描述

根据指定的参数更新服务。这些参数与 docker service create 相同。有关更多信息，请参阅那里的描述。

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

注意

这是一个集群管理命令，必须在 Swarm 管理节点上执行。要了解管理器和工作节点，请参阅文档中的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标志采用与service create上的--mount标志相同的参数。有关详细信息，请参阅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)

使用--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支持与service create相同的--isolation标志。有关参考，请参阅service create。

更新作业

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

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

作业无法回滚或回滚。所有用于配置更新或回滚设置的标志在作业模式下均无效。

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