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 标志需要挂载的目标路径。

$ 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。

更新 Job

当服务创建为 job 时（通过在执行 service create 时将其模式设置为 replicated-job 或 global-job），更新它的选项是有限的。

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

Job 无法进行滚动更新 (rolled out) 或回滚 (rolled back)。配置更新或回滚设置的任何标志对于 job 模式都无效。

要使用之前运行时的相同参数再次运行 job，可以使用 --force 标志进行强制更新。