docker 容器更新

描述更新一个或多个容器的配置
用法docker container update [OPTIONS] CONTAINER [CONTAINER...]
别名
docker update

描述

docker update命令动态更新容器配置。您可以使用此命令来防止容器消耗 Docker 主机的过多资源。使用单个命令,您可以对单个容器或多个容器进行限制。要指定多个容器,请提供以空格分隔的容器名称或 ID 列表。

除了该--kernel-memory选项之外,您可以在正在运行或已停止的容器上指定这些选项。在早于 4.6 的内核版本上,您只能--kernel-memory在已停止的容器或已初始化内核内存的正在运行的容器上进行更新。

警告

Windows 容器不支持docker update和命令。docker container update

选项

选项默认描述
--blkio-weight块 IO(相对权重),介于 10 到 1000 之间,或 0 禁用(默认 0)
--cpu-period限制CPU CFS(完全公平调度程序)周期
--cpu-quota限制CPU CFS(完全公平调度程序)配额
--cpu-rt-periodAPI 1.25+ 以微秒为单位限制 CPU 实时周期
--cpu-rt-runtimeAPI 1.25+ 以微秒为单位限制 CPU 实时运行时间
-c, --cpu-sharesCPU 份额(相对权重)
--cpusAPI 1.29+ CPU 数量
--cpuset-cpus允许执行的 CPU (0-3, 0,1)
--cpuset-mems允许执行的 MEM (0-3, 0,1)
-m, --memory内存限制
--memory-reservation内存软限制
--memory-swap交换限制等于内存加交换:-1 启用无限制交换
--pids-limitAPI 1.40+ 调整容器 pid 限制(设置 -1 表示无限制)
--restart容器退出时应用的重新启动策略

例子

以下部分说明了使用此命令的方法。

更新容器的 cpu-shares (--cpu-shares)

要将容器的 cpu 份额限制为 512,请首先确定容器名称或 ID。您可以使用docker ps来查找这些值。您还可以使用从命令返回的 ID docker run。然后,执行以下操作:

$ docker update --cpu-shares 512 abebf7571666

使用 cpu 份额和内存更新容器 (-m, --memory)

要更新多个容器的多个资源配置:

$ docker update --cpu-shares 512 -m 300M abebf7571666 hopeful_morse

更新容器的内核内存约束(--kernel-memory)

您可以使用该选项更新容器的内核内存限制--kernel-memory 。在早于 4.6 的内核版本上,仅当容器以--kernel-memory.如果容器已启动,则--kernel-memory需要在更新内核内存之前停止容器。

笔记

--kernel-memory选项自 Docker 20.10 起已被弃用。

例如,如果您使用以下命令启动了一个容器:

$ docker run -dit --name test --kernel-memory 50M ubuntu bash

您可以在容器运行时更​​新内核内存:

$ docker update --kernel-memory 80M test

如果您启动了一个没有初始化内核内存的容器:

$ docker run -dit --name test2 --memory 300M ubuntu bash

更新正在运行的容器的内核内存test2将失败。您需要在更新设置之前停止容器--kernel-memory。下次启动时,容器将使用新值。

比(含)4.6更新的内核版本没有此限制,您可以使用--kernel-memory与其他选项相同的方式。

更新容器的重启策略(--restart)

您可以更改正在运行的容器的容器重启策略。新的重启策略docker update在容器上运行后立即生效。

要更新一个或多个容器的重启策略:

$ docker update --restart=on-failure:3 abebf7571666 hopeful_morse

请注意,如果容器是使用--rm标志启动的,则无法更新其重启策略。对于容器来说 和 是互斥的AutoRemoveRestartPolicy