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

docker compose restart: перезапуск сервисов и проверка

Команда docker compose restart перезапускает контейнеры проекта, не пересоздавая их и не подхватывая изменения в compose-файле.

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

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

На сервере уже должен быть Docker Compose v2. Это плагин, команда пишется через пробел: docker compose. Старый docker-compose (v1) не поддерживается с 2023 года. Если команда не найдена, установите пакет docker-compose-plugin из репозитория Docker.

bash
docker compose version

02Перейдите в каталог проекта

Compose ищет файл compose.yaml или docker-compose.yml в текущем каталоге. Если файла нет, команда завершится ошибкой no configuration file provided: not found. Путь можно указать явно через -f, но проще перейти в каталог проекта.

bash
cd /var/www/example.com
docker compose config

03Перезапустите сервисы командой restart

docker compose restart останавливает и снова запускает контейнеры в том виде, в каком они созданы. Изменения в compose.yaml, новые образы и переменные окружения при этом не применяются. Если нужно перечитать конфиг, используйте пересоздание контейнеров.

bash
docker compose restart

04Перезапустите один сервис

Если проблема в одном контейнере, укажите его имя. Имя сервиса берётся из compose.yaml, например app. Остальные контейнеры проекта продолжат работу.

bash
docker compose restart app

05Остановите проект командой stop

docker compose stop останавливает контейнеры, не удаляя их. Тома и сети сохраняются, docker compose start вернёт всё в работу. Для полного удаления контейнеров и сетей служит docker compose down, именованные тома переживают и его.

bash
docker compose stop
docker compose start

06Обновите образы командой pull

docker compose pull скачивает свежие версии образов, указанных в файле. Сами контейнеры после этого работают на старых образах, пока их не пересоздать. Тег latest в compose.yaml означает, что при каждом pull может приехать другая версия.

bash
docker compose pull

07Пересоздайте контейнеры с новыми образами

docker compose up -d пересоздаёт контейнеры, у которых изменился образ или конфиг, и запускает проект в фоне. Это штатный способ обновления после pull. Флаг --force-recreate пересоздаёт все контейнеры даже без изменений.

bash
docker compose up -d
docker compose up -d --force-recreate

08Проверьте, что сервисы работают

docker compose ps показывает статус контейнеров проекта. В колонке STATUS должно быть Up, а не Restarting или Exited. Логи сервиса app показывают, почему контейнер не поднялся.

bash
docker compose ps
docker compose logs -f app

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

  • После docker compose restart изменения в compose.yaml не применяются: контейнеры запускаются со старым конфигом.

    Пересоздайте контейнеры командой docker compose up -d. Для принудительного пересоздания всех сервисов добавьте --force-recreate.

  • docker compose pull скачал новый образ, но приложение работает на старой версии.

    После pull выполните docker compose up -d, чтобы контейнеры пересоздались на новом образе.

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

    Добавьте пользователя в группу docker командой sudo usermod -aG docker $USER и войдите на сервер заново. Группа docker даёт права root.

  • Контейнер после перезапуска сразу падает с кодом выхода 137.

    Код 137 значит, что процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Проверьте docker compose logs app и лимиты памяти на сервере.

Deploykin

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

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

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

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

Чем docker compose restart отличается от docker compose up -d?

restart перезапускает существующие контейнеры с прежним конфигом. up -d пересоздаёт контейнеры, если изменился образ или compose.yaml.

Подхватывает ли docker compose restart новые переменные из .env?

Нет. Переменные окружения задаются при создании контейнера, поэтому после правки .env нужно выполнить docker compose up -d.

Как перезапустить только один сервис?

Укажите имя сервиса из compose.yaml: docker compose restart app. Остальные контейнеры проекта не затрагиваются.

Удаляет ли docker compose down данные в томах?

Именованные тома переживают docker compose down. Удаляет их только docker compose down -v.

Ещё по теме

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

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