docker container update

描述

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

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

警告

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

选项

示例

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

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

要将容器的 cpu-shares 限制为 512，首先确定容器名称或 ID。您可以使用 docker ps 查找这些值。您也可以使用 docker run 命令返回的 ID。然后，执行以下操作：

$ docker update --cpu-shares 512 abebf7571666

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

更新多个容器的多项资源配置：

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

更新容器的内核内存限制 (--kernel-memory)

您可以使用 --kernel-memory 选项更新容器的内核内存限制。在 4.6 之前的内核版本中，仅当容器是以 --kernel-memory 启动时，才能在运行中的容器上更新此选项。如果容器启动时未指定 --kernel-memory，则需要在更新内核内存之前停止容器。

注意

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

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

$ 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 标志启动的，则无法为其更新重启策略。对于该容器，AutoRemove 和 RestartPolicy 是互斥的。