©
本文档使用
php.cn手册 发布
描述
更新服务
使用
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标志将导致任务被重新创建。这可以用来执行滚动重启，而不会对服务参数进行任何更改。
实例
更新服务
$ 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参考。