К содержимому

docker update: изменение лимитов контейнера на Ubuntu 24.04

Команда docker update меняет лимиты CPU, памяти и политику перезапуска у уже запущенного контейнера без его пересоздания. На Ubuntu 24.04 она работает с Docker Engine из репозитория Docker и не требует остановки контейнера. Изменения применяются сразу и сохраняются до следующего docker run или docker compose up, который пересоздаст контейнер с параметрами из команды или compose-файла.

Руководство Docker 3 мин чтения

01Проверьте, что Docker установлен

Убедитесь, что на сервере есть Docker Engine и клиент. Команда docker version печатает версии клиента и сервера, а также API. Если вывод обрывается на строке Client и следом идёт ошибка подключения к сокету, серверная часть не запущена или у пользователя нет прав. Установка Docker расписана на отдельной странице темы, здесь она не повторяется.

bash
docker version

02Посмотрите текущие лимиты контейнера

Найдите имя или ID контейнера и его текущие ограничения. Команда docker inspect с фильтром по HostConfig показывает поля Memory, NanoCpus и RestartPolicy. Если Memory равно 0, лимит памяти не задан, и контейнер может занять всю доступную память хоста.

bash
docker ps
docker inspect --format '{{.Name}} Memory={{.HostConfig.Memory}} NanoCpus={{.HostConfig.NanoCpus}} Restart={{.HostConfig.RestartPolicy.Name}}' <container>

03Задайте лимит памяти

Лимит памяти задаётся флагом --memory в байтах или с суффиксом m и g. Значение 512m означает 512 мебибайт. Команда меняет только HostConfig.Memory, ядро применяет новое ограничение к работающему контейнеру сразу. Если новый лимит меньше текущего потребления, контейнер не перезапускается, но следующий крупный запрос памяти может привести к убийству процесса сигналом SIGKILL и коду выхода 137.

bash
docker update --memory 512m <container>

04Задайте лимит CPU

Флаг --cpus принимает дробное число ядер. Значение 1.5 разрешает контейнеру использовать полтора ядра, 0.5 половину ядра. В HostConfig.NanoCpus Docker хранит это же значение в наноЯдрах: для --cpus 1.5 там будет 1500000000, для --cpus 0.5 будет 500000000. Флаг --cpu-shares задаёт относительный вес при конкуренции за процессор и по умолчанию равен 1024.

bash
docker update --cpus 1.5 <container>
docker update --cpu-shares 512 <container>

05Измените политику перезапуска

Политика перезапуска определяет, что Docker делает с контейнером после падения или перезагрузки хоста. Значение unless-stopped поднимает контейнер после перезагрузки сервера, если его не остановили вручную. Значение no отключает автоматический перезапуск. Смена политики через docker update не требует остановки контейнера.

bash
docker update --restart unless-stopped <container>

06Проверьте, что лимиты применились

Повторите docker inspect и сравните поля с заданными значениями. Затем посмотрите docker stats без потока, чтобы увидеть текущее потребление памяти и CPU относительно новых лимитов. В колонке MEM USAGE / LIMIT справа появится новое ограничение, например 512MiB.

bash
docker inspect --format '{{.Name}} Memory={{.HostConfig.Memory}} NanoCpus={{.HostConfig.NanoCpus}} Restart={{.HostConfig.RestartPolicy.Name}}' <container>
docker stats --no-stream <container>

Частые ошибки

  • После docker update --memory контейнер падает с кодом выхода 137, и это считают доказательством нехватки памяти.

    Код 137 значит, что процесс убит сигналом SIGKILL. Чаще всего это OOM-killer из-за нового лимита, но причиной может быть и ручной kill -9. Проверьте docker inspect --format '{{.State.OOMKilled}}' <container> и dmesg | grep -i oom.

  • Для --cpus 1.5 в HostConfig.NanoCpus ожидают увидеть 1.5e9, умноженное ещё раз, и получают неверное значение.

    NanoCpus уже хранит значение в наноЯдрах: --cpus 1.5 даёт 1500000000, --cpus 0.5 даёт 500000000. Умножать на 1e9 нужно только число ядер, а не готовое значение из docker inspect.

  • Лимиты, заданные через docker update, пропадают после docker compose up -d.

    docker compose up пересоздаёт контейнер из compose-файла и берёт лимиты оттуда. Пропишите mem_limit и cpus в сервисе compose-файла, тогда docker update не понадобится после каждого пересоздания.

  • docker update завершается ошибкой permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Пользователь не в группе docker или не вошёл заново после sudo usermod -aG docker $USER. Выйдите из сессии и войдите снова либо выполните команду через sudo.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Можно ли менять лимиты у работающего контейнера без его остановки?

Да, docker update применяет новые лимиты памяти, CPU и политику перезапуска к запущенному контейнеру. Останавливать и пересоздавать его не нужно.

Сохранятся ли лимиты после перезапуска контейнера?

Лимиты хранятся в конфигурации контейнера и переживают docker restart и перезагрузку хоста. Они сбрасываются, когда контейнер удаляют и создают заново, например через docker compose up -d.

Как задать лимит памяти в compose-файле вместо docker update?

В сервисе compose-файла укажите mem_limit: 512m и cpus: 1.5. После docker compose up -d контейнер получит эти значения при создании, и docker update для них не понадобится.

Почему после docker update контейнер стал падать с кодом 137?

Код 137 значит, что процесс убит сигналом SIGKILL. Чаще всего это OOM-killer из-за слишком низкого лимита памяти, но причиной может быть и ручной kill -9. Поднимите лимит или проверьте потребление через docker stats.

Можно ли через docker update изменить опубликованные порты?

Нет, порты задаются при создании контейнера и через docker update не меняются. Контейнер придётся пересоздать с новым -p или с новым разделом ports в compose-файле.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.