docker compose restart: перезапуск сервисов и проверка
Команда docker compose restart перезапускает контейнеры проекта, не пересоздавая их и не подхватывая изменения в compose-файле.
01Проверьте, что Docker Compose установлен
На сервере уже должен быть Docker Compose v2. Это плагин, команда пишется через пробел: docker compose. Старый docker-compose (v1) не поддерживается с 2023 года. Если команда не найдена, установите пакет docker-compose-plugin из репозитория Docker.
docker compose version
02Перейдите в каталог проекта
Compose ищет файл compose.yaml или docker-compose.yml в текущем каталоге. Если файла нет, команда завершится ошибкой no configuration file provided: not found. Путь можно указать явно через -f, но проще перейти в каталог проекта.
cd /var/www/example.com
docker compose config
03Перезапустите сервисы командой restart
docker compose restart останавливает и снова запускает контейнеры в том виде, в каком они созданы. Изменения в compose.yaml, новые образы и переменные окружения при этом не применяются. Если нужно перечитать конфиг, используйте пересоздание контейнеров.
docker compose restart
04Перезапустите один сервис
Если проблема в одном контейнере, укажите его имя. Имя сервиса берётся из compose.yaml, например app. Остальные контейнеры проекта продолжат работу.
docker compose restart app
05Остановите проект командой stop
docker compose stop останавливает контейнеры, не удаляя их. Тома и сети сохраняются, docker compose start вернёт всё в работу. Для полного удаления контейнеров и сетей служит docker compose down, именованные тома переживают и его.
docker compose stop
docker compose start
06Обновите образы командой pull
docker compose pull скачивает свежие версии образов, указанных в файле. Сами контейнеры после этого работают на старых образах, пока их не пересоздать. Тег latest в compose.yaml означает, что при каждом pull может приехать другая версия.
docker compose pull
07Пересоздайте контейнеры с новыми образами
docker compose up -d пересоздаёт контейнеры, у которых изменился образ или конфиг, и запускает проект в фоне. Это штатный способ обновления после pull. Флаг --force-recreate пересоздаёт все контейнеры даже без изменений.
docker compose up -d
docker compose up -d --force-recreate
08Проверьте, что сервисы работают
docker compose ps показывает статус контейнеров проекта. В колонке STATUS должно быть Up, а не Restarting или Exited. Логи сервиса app показывают, почему контейнер не поднялся.
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 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: руководство по работе с многоконтейнерными приложениями: все материалы темы