文档建议反馈控制台
首页
学习
活动
专区
工具
TVP
最新优惠活动
文章/答案/技术大牛
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

docker service update

描述

更新服务

使用

代码语言：javascript
复制
docker service update [OPTIONS] SERVICE

备选方案

名字，简写

默认

描述

--args

?

服务命令参数

--config-add

?

添加或更新服务上的配置文件

--config-RM

?

删除配置文件

--constraint-add

?

添加或更新展示位置约束

--constraint-RM

?

删除约束

--container-label-add

?

添加或更新容器标签

--container-label-rm

?

用钥匙取出容器标签

--credential-spec

?

托管服务帐户的凭证规范（仅限Windows）

--detach，-d

真

立即退出，而不是等待服务收敛

--dns-add

?

添加或更新自定义DNS服务器

--dns-option-add

?

添加或更新DNS选项

--dns-option-rm

?

删除一个DNS选项

--dns-rm

?

删除自定义的DNS服务器

--dns-search-add

?

添加或更新自定义DNS搜索域

--dns-search-rm

?

删除一个DNS搜索域

--endpoint-mode

?

端点模式（vip或dnsrr）

--entrypoint

?

覆盖图像的默认入口点

--env-add

?

添加或更新环境变量

--env-RM

?

删除一个环境变量

--force

假

即使没有更改需要，也强制更新

--group-add

?

向容器添加一个附加的补充用户组

--group-RM

?

从容器中删除先前添加的补充用户组

--health-cmd

?

运行以检查运行状况的命令

--health-interval

?

运行检查之间的时间（ms | s | m | h）

--health-retries

0

需要报告不健康的连续失败

--health-retries

?

在重新计数到不稳定（ms | s | m | h）之前，容器初始化的开始时间段

--health-timeout

?

允许一次检查运行的最长时间（ms | s | m | h）

--host加

?

添加或更新自定义主机到IP映射（主机：IP）

--host-RM

?

删除自定义的主机到IP映射（主机：IP）

--hostname

?

容器主机名

--image

?

服务图片标签

--label-add

?

添加或更新服务标签

--label-RM

?

用钥匙去除标签

--limit-CPU

?

限制CPU

--limit-memory

0

限制记忆

--log-driver

?

记录驱动程序的服务

--log-OPT

?

记录驱动程序选项

--mount-add

?

添加或更新服务上的装载

--mount-RM

?

通过目标路径移除一个安装

--network加

?

添加一个网络

--network-RM

?

删除网络

--no-healthcheck

假

禁用任何容器指定的HEALTHCHECK

--no-resolve-image

假

不要查询注册表来解析图像摘要和支持的平台

--placement-PREF-ADD

?

添加展示位置首选项

--placement-PREF-RM

?

删除展示位置偏好设置

--publish相加

?

添加或更新已发布的端口

--publish-RM

?

通过目标端口删除发布的端口

--quiet，-q

假

抑制进度输出

--read-only

假

将容器的根文件系统挂载为只读

--replicas

?

任务数量

--reserve-CPU

?

预留CPU

--reserve-memory

0

保留内存

--restart-condition

?

条件满足时重新启动（“none”|“on-failure”|“any”）

--restart-delay

?

重启尝试之间的延迟（ns | us | ms | s | m | h）

--restart-max-attempts

?

放弃前的最大重启次数

--restart-window

?

用于评估重新启动策略的窗口（ns | us | ms | s | m | h）

--rollback

假

回退到先前的规范

--rollback-delay

0

任务回滚之间的延迟（ns | us | ms | s | m | h）

--rollback-failure-action

?

回滚失败的操作（“暂停”|“继续”）

--rollback-max-failure-ratio

0

在回滚期间容忍的失败率

--rollback-monitor

0

每个任务回滚后监视失败的持续时间（ns | us | ms | s | m | h）

--rollback-order

?

回滚顺序（“start-first”|“stop-first”）

--rollback-parallelism

0

同时回滚的任务的最大数量（0一次全部回滚）

--secret-add

?

添加或更新服务的秘密

--secret-RM

?

去掉一个秘密

--stop-grace-period

?

强制杀死一个容器之前的等待时间（ns | us | ms | s | m | h）

--stop-signal

?

停止容器的信号

--tty, -t

假

分配一个伪TTY

--update-delay

0

更新之间的延迟（ns | us | ms | s | m | h）

--update-failure-action

?

更新失败的操作（“暂停”|“继续”|“回滚”）

--update-max-failure-ratio

0

更新期间容错的失败率

--update-monitor

0

（ns | us | ms | s | m | h）每个任务更新后的持续时间

--update-order

?

更新顺序（“start-first”|“stop-first”）

--update-parallelism

0

同时更新的最大任务数（0个一次全部更新）

--user，-u

?

用户名或UID（格式：<名称| uid>：<组| gid>）

--with-registry-auth

假

向注册代理发送注册表认证详细信息

--workdir，-w

?

容器内的工作目录

父命令

命令

描述

docker 服务

管理服务

相关命令

命令

描述

docker 服务创建

创建一项新服务

docker 服务检查

显示一项或多项服务的详细信息

docker 服务日志

获取服务或任务的日志

docker 服务ls

列出服务

docker 服务ps

列出一项或多项服务的任务

docker 服务rm

删除一项或多项服务

docker 服务规模

扩展一个或多个复制服务

docker 服务更新

更新服务

扩展描述

按照指定的参数描述更新服务。该命令必须以管理器节点为目标运行。参数与docker service create。相同。请参阅描述以获取更多信息。

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

实例

更新服务

代码语言：javascript
复制
$ docker service update --limit-cpu 2 redis

执行滚动重新启动，不更改参数。

代码语言：javascript
复制
$ 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安装路径。
代码语言：javascript
复制
$ 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，然后回滚到以前的配置。

代码语言：javascript
复制
$ docker service update --replicas=5 web

web

$ docker service ls

ID            NAME  MODE        REPLICAS  IMAGE
80bvrzp6vxf3  web   replicated  0/5       nginx:alpine

回滚web服务...

代码语言：javascript
复制
$ 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执行任务之间没有延迟的回滚：

代码语言：javascript
复制
$ 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：

代码语言：javascript
复制
$ docker service update \
    --secret-add source=ssh-2,target=ssh-2 \
    --secret-rm ssh-1 \
    myservice

使用模板更新服务

service update支持使用模板的一些标志。请参阅service create参考。

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

扫码关注腾讯云开发者

领取腾讯云代金券

http://www.vxiaotou.com