docker service update

docker 服务更新

描述

更新服务

使用

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

以下示例创建一个将test-datavolume挂载到的服务/somewhere。下一步更新服务以将other-volumevolume挂接到/somewhere-elsevolume，最后一步卸载/somewhere挂载点，从而有效地移除test-datavolume。每个命令都会返回服务名称。

• --mount-add标志采用了相同的参数--mount上的标志service create。有关详细信息，请参阅参考中的volume和绑定挂载部分service create。

• --mount-rm标志采用target安装路径。

$ docker service create \
    --name=myservice \
    --mount \
      type=volume,source=test-data,target=/somewhere \
    nginx:alpine \
    myservice

myservice

$ docker service update \
    --mount-add \
      type=volume,source=other-volume,target=/somewhere-else \
    myservice

myservice

$ docker service update --mount-rm /somewhere myservice

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参考。