docker update: изменение лимитов контейнера на Ubuntu 24.04
Команда docker update меняет лимиты CPU, памяти и политику перезапуска у уже запущенного контейнера без его пересоздания. На Ubuntu 24.04 она работает с Docker Engine из репозитория Docker и не требует остановки контейнера. Изменения применяются сразу и сохраняются до следующего docker run или docker compose up, который пересоздаст контейнер с параметрами из команды или compose-файла.
01Проверьте, что Docker установлен
Убедитесь, что на сервере есть Docker Engine и клиент. Команда docker version печатает версии клиента и сервера, а также API. Если вывод обрывается на строке Client и следом идёт ошибка подключения к сокету, серверная часть не запущена или у пользователя нет прав. Установка Docker расписана на отдельной странице темы, здесь она не повторяется.
docker version
02Посмотрите текущие лимиты контейнера
Найдите имя или ID контейнера и его текущие ограничения. Команда docker inspect с фильтром по HostConfig показывает поля Memory, NanoCpus и RestartPolicy. Если Memory равно 0, лимит памяти не задан, и контейнер может занять всю доступную память хоста.
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.
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.
docker update --cpus 1.5 <container>
docker update --cpu-shares 512 <container>
05Измените политику перезапуска
Политика перезапуска определяет, что Docker делает с контейнером после падения или перезагрузки хоста. Значение unless-stopped поднимает контейнер после перезагрузки сервера, если его не остановили вручную. Значение no отключает автоматический перезапуск. Смена политики через docker update не требует остановки контейнера.
docker update --restart unless-stopped <container>
06Проверьте, что лимиты применились
Повторите docker inspect и сравните поля с заданными значениями. Затем посмотрите docker stats без потока, чтобы увидеть текущее потребление памяти и CPU относительно новых лимитов. В колонке MEM USAGE / LIMIT справа появится новое ограничение, например 512MiB.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы