Docker CLI docker service update 常用命令

1、docker service update 简介

docker service update 命令是用于更新 Docker Swarm 中的服务配置。它允许你修改服务的各种属性，如镜像、环境变量、副本数等。

该命令与Swarm编排器一起工作。

更新一个服务，根据指定的参数进行描述。这些参数与 docker service create 相同。进一步的信息请参考 docker service create 的描述。

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

注意：

此命令是一个集群管理命令，必须在 Swarm 管理节点上执行。有关管理节点和工作节点的详细信息，请参阅文档中的 Swarm 模式部分。

参考文档：https://docs.docker.com/engine/reference/commandline/service_update/

2、docker service update 语法

docker service update [OPTIONS] SERVICE

3、docker service update 命令

1）更新服务

docker service update --limit-cpu 2 redis

2）使用没有参数变化的滚动重启

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

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

3）添加或移除挂载 (--mount-add，--mount-rm)

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

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

--mount-add 标志接受与服务创建参考中的 --mount 标志相同的参数。有关详细信息，请参阅服务创建参考中的卷和绑定挂载部分。

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

4）添加或移除已发布的服务端口 (--publish-add，--publish-rm)

使用 --publish-add 或 --publish-rm 标志为服务添加或移除已发布的端口。您可以使用 docker service create 参考中讨论的短语法或长语法。

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

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

5）添加或移除网络 (--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

6）回滚到服务的上一个版本 (--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 手动发起的回滚中都会被尊重。

7）添加或移除密钥信息 (--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

8）使用模板更新服务

某些服务更新的标志支持使用模板。有关详情，请参阅服务创建参考。

9）在 Windows 上指定隔离模式 (--isolation)

service update 支持与 service create 相同的 --isolation 标志。有关详情，请参阅服务创建参考。

10）更新作业

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

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

作业无法进行滚动升级或回滚。在作业模式下，无法使用任何配置更新或回滚设置的标志。

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

4、命令选项

5、子命令