docker compose run command на Ubuntu 24.04: пошаговая инструкция
Команда docker compose run запускает разовый контейнер сервиса с другой командой вместо той, что указана в command. Она поднимает зависимости сервиса, подключает его тома и сеть проекта, а порты по умолчанию не публикует.
01Проверьте, что Docker Compose установлен
На сервере нужен плагин Compose v2, команда пишется через пробел: docker compose. Старый бинарник docker-compose не поддерживается с 2023 года. Установка Docker и плагина описана на отдельной странице, здесь достаточно одной команды проверки.
docker compose version
02Перейдите в каталог проекта
docker compose run ищет файл compose.yaml или docker-compose.yml в текущем каталоге. Если файла нет, команда завершится ошибкой no configuration file provided: not found. Путь к файлу можно задать флагом -f, но проще перейти в каталог проекта.
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 отключает запуск зависимостей, если они уже работают.
docker compose run --rm app php -v
docker compose run --rm --no-deps app php -v
05Откройте интерактивную оболочку
Для интерактивной сессии нужны флаги -it: -i оставляет stdin открытым, -t выделяет псевдотерминал. Флаг --rm удаляет контейнер после выхода и на интерактивность не влияет. Без --rm разовые контейнеры остаются в списке и копятся.
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.
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 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: руководство по работе с многоконтейнерными приложениями: все материалы темы