mirror of https://github.com/docker/cli.git
Soften limitation of update kernel memory
Kernel memory is not allowed to be updated if container is running, it's not actually a precise kernel limitation. Before kernel version 4.6, kernel memory will not be accounted until kernel memory limit is set, if a container created with kernel memory initialized, kernel memory is accounted as soon as process created in container, so kernel memory limit update is allowed afterward. If kernel memory is not initialized, kernel memory consumed by processes in container will not be accounted, so we can't update the limit because the account will be wrong. So update kernel memory of a running container with kernel memory initialized is allowed, we should soften the limitation by docker. Signed-off-by: Qiang Huang <h.huangqiang@huawei.com>
This commit is contained in:
parent
e8b87f53ec
commit
670a0b8077
|
@ -38,9 +38,23 @@ space-separated list of container names or IDs.
|
||||||
|
|
||||||
With the exception of the `--kernel-memory` value, you can specify these
|
With the exception of the `--kernel-memory` value, you can specify these
|
||||||
options on a running or a stopped container. You can only update
|
options on a running or a stopped container. You can only update
|
||||||
`--kernel-memory` on a stopped container. When you run `docker update` on
|
`--kernel-memory` on a stopped container or on a running container with
|
||||||
stopped container, the next time you restart it, the container uses those
|
kernel memory initialized. For example, if you started a container with
|
||||||
values.
|
command:
|
||||||
|
|
||||||
|
# docker run -ti --name test --kernel-memory 50M ubuntu bash
|
||||||
|
|
||||||
|
You can update kernel memory of this running container:
|
||||||
|
|
||||||
|
# docker update --kernel-memory 80M test
|
||||||
|
|
||||||
|
If you started a container without kernel memory initialized:
|
||||||
|
|
||||||
|
# docker run -ti --name test2 --memory 300M ubuntu bash
|
||||||
|
|
||||||
|
Update kernel memory of running container `test2` will fail, you can only
|
||||||
|
stop the container and update kernel memory then. The next time you
|
||||||
|
restart it, the container uses the new value.
|
||||||
|
|
||||||
Another configuration you can change with this command is restart policy,
|
Another configuration you can change with this command is restart policy,
|
||||||
new restart policy will take effect instantly after you run `docker update`
|
new restart policy will take effect instantly after you run `docker update`
|
||||||
|
|
|
@ -30,9 +30,23 @@ provide space-separated list of container names or IDs.
|
||||||
|
|
||||||
With the exception of the `--kernel-memory` value, you can specify these
|
With the exception of the `--kernel-memory` value, you can specify these
|
||||||
options on a running or a stopped container. You can only update
|
options on a running or a stopped container. You can only update
|
||||||
`--kernel-memory` on a stopped container. When you run `docker update` on
|
`--kernel-memory` on a stopped container or on a running container with
|
||||||
stopped container, the next time you restart it, the container uses those
|
kernel memory initialized. For example, if you started a container with
|
||||||
values.
|
command:
|
||||||
|
|
||||||
|
# docker run -ti --name test --kernel-memory 50M ubuntu bash
|
||||||
|
|
||||||
|
You can update kernel memory of this running container:
|
||||||
|
|
||||||
|
# docker update --kernel-memory 80M test
|
||||||
|
|
||||||
|
If you started a container without kernel memory initialized:
|
||||||
|
|
||||||
|
# docker run -ti --name test2 --memory 300M ubuntu bash
|
||||||
|
|
||||||
|
Update kernel memory of running container `test2` will fail, you can only
|
||||||
|
stop the container and update kernel memory then. The next time you
|
||||||
|
restart it, the container uses the new value.
|
||||||
|
|
||||||
Another configuration you can change with this command is restart policy,
|
Another configuration you can change with this command is restart policy,
|
||||||
new restart policy will take effect instantly after you run `docker update`
|
new restart policy will take effect instantly after you run `docker update`
|
||||||
|
@ -63,8 +77,9 @@ on a container.
|
||||||
**--kernel-memory**=""
|
**--kernel-memory**=""
|
||||||
Kernel memory limit (format: `<number>[<unit>]`, where unit = b, k, m or g)
|
Kernel memory limit (format: `<number>[<unit>]`, where unit = b, k, m or g)
|
||||||
|
|
||||||
Note that you can not update kernel memory to a running container, it can only
|
Note that you can not update kernel memory to a running container if the container
|
||||||
be updated to a stopped container, and affect after it's started.
|
is started without kernel memory initialized, in this case, it can only be updated
|
||||||
|
after it's stopped, and affect after it's started.
|
||||||
|
|
||||||
**-m**, **--memory**=""
|
**-m**, **--memory**=""
|
||||||
Memory limit (format: <number><optional unit>, where unit = b, k, m or g)
|
Memory limit (format: <number><optional unit>, where unit = b, k, m or g)
|
||||||
|
|
Loading…
Reference in New Issue