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

docker compose run command на Ubuntu 24.04: пошаговая инструкция

Команда docker compose run запускает разовый контейнер сервиса с другой командой вместо той, что указана в command. Она поднимает зависимости сервиса, подключает его тома и сеть проекта, а порты по умолчанию не публикует.

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

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

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

bash
docker compose version

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

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

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

03Проверьте конфигурацию перед запуском

docker compose config проверяет YAML и печатает итоговый конфиг с подставленными переменными. Ошибка yaml: line 12: did not find expected key означает проблему отступов или кавычек рядом с указанной строкой. Отступы делают пробелами, табуляция недопустима.

04Запустите разовую команду в сервисе

Укажите имя сервиса из compose.yaml и команду после него. По умолчанию docker compose run поднимает зависимости сервиса, например базу db, и подключает контейнер к сети проекта. Флаг --no-deps отключает запуск зависимостей, если они уже работают.

bash
docker compose run --rm app php -v
docker compose run --rm --no-deps app php -v

05Откройте интерактивную оболочку

Для интерактивной сессии нужны флаги -it: -i оставляет stdin открытым, -t выделяет псевдотерминал. Флаг --rm удаляет контейнер после выхода и на интерактивность не влияет. Без --rm разовые контейнеры остаются в списке и копятся.

bash
docker compose run --rm -it app sh

06Учтите работу с портами и томами

docker compose run по умолчанию не публикует порты сервиса, поэтому конфликт Bind for 0.0.0.0:80 failed: port is already allocated при разовом запуске не возникает. Тома и bind mount подключаются как при обычном запуске. Bind mount сохраняет UID и GID файлов хоста, поэтому владельца каталога подбирают под пользователя в контейнере.

07Проверьте результат

Команда печатает вывод в терминал, а код выхода показывает успех или ошибку. Код 137 значит, что процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Список контейнеров проекта покажет, остались ли разовые контейнеры после запуска без --rm.

bash
docker compose run --rm app php -r 'echo PHP_VERSION, PHP_EOL;'
echo $?
docker compose ps

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

  • Пользователь запускает docker compose run и получает 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 на сервере.

  • После выхода из интерактивной сессии остаются остановленные разовые контейнеры, и они занимают имена.

    Запускайте с флагом --rm, он удаляет контейнер после завершения. Уже созданные разовые контейнеры удаляет docker compose rm.

  • При записи в смонтированный каталог возникает Permission denied.

    UID пользователя в контейнере не совпадает с владельцем каталога на хосте. В официальных образах php на Debian www-data это UID 33, на Alpine UID 82: подберите владельца каталога под пользователя в контейнере.

  • docker compose run завершается с ошибкой no configuration file provided: not found.

    Команда выполняется не в каталоге проекта. Перейдите в каталог с compose.yaml или укажите путь флагом -f.

Deploykin

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

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

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

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

Чем docker compose run отличается от docker compose exec?

run создаёт новый разовый контейнер сервиса с указанной командой, а exec выполняет команду в уже работающем контейнере. Для проверки или миграции на копии сервиса используют run, для входа в работающий контейнер exec.

Публикует ли docker compose run порты сервиса?

По умолчанию нет, порты не публикуются, поэтому конфликт с занятым портом при разовом запуске не возникает. Публикацию можно включить флагом --service-ports.

Поднимает ли docker compose run зависимости сервиса?

Да, по умолчанию запускаются сервисы из depends_on. Флаг --no-deps отключает их запуск, если зависимости уже работают.

Почему после docker compose run остался контейнер?

Без флага --rm разовый контейнер сохраняется после завершения. Добавьте --rm при запуске или удалите контейнеры командой docker compose rm.

Ещё по теме

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

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