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

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

Docker Compose запускает несколько контейнеров одной командой по описанию в файле compose.yaml. Он поднимает сеть, тома и сервисы в нужном порядке, а останавливает и пересоздаёт их без ручного ввода длинных команд docker run. На этой странице собраны установка, основные команды, конфигурация и разбор частых ошибок.

Опорная Docker 4 мин чтения 33 материала в теме

Что такое Docker Compose и как он работает

Docker Compose читает файл compose.yaml в каталоге проекта и создаёт из него контейнеры, сеть и тома. Каждый сервис в файле получает имя, образ или инструкцию сборки, порты и переменные окружения. При запуске Compose создаёт отдельную сеть, в которой контейнеры обращаются друг к другу по именам сервисов. Состояние проекта хранится в метках контейнеров, поэтому команды up и down работают с целой группой, а не с отдельными контейнерами.

Установка Docker Compose на Ubuntu 24.04

В Ubuntu 24.04 пакет docker-compose-plugin ставится из официального репозитория Docker. После установки команда вызывается как docker compose с пробелом, а не как отдельный бинарник docker-compose. Проверить версию можно командой docker compose version.

bash
sudo apt update
sudo apt install -y docker-compose-plugin
docker compose version

Основные команды Docker Compose

Запуск всех сервисов в фоне выполняет docker compose up -d. Посмотреть статус контейнеров проекта позволяет docker compose ps, а логи одного сервиса в реальном времени выводят через docker compose logs -f app. Остановка и удаление контейнеров вместе с сетью выполняет docker compose down, при этом тома сохраняются, если не указан флаг -v. Внутрь работающего контейнера заходят командой docker compose exec app sh.

bash
docker compose up -d
docker compose ps
docker compose logs -f app
docker compose down
docker compose exec app sh

Файл compose.yaml: структура и пример

Файл compose.yaml лежит в корне проекта и начинается с ключа services. В примере описаны два сервиса: nginx с пробросом порта 80 и php-fpm, который обрабатывает скрипты из каталога /var/www/example.com. Оба сервиса находятся в одной сети по умолчанию и видят друг друга по именам. Проверить синтаксис перед запуском можно командой docker compose config.

yaml
services:
  web:
    image: nginx:1.27
    ports:
      - "80:80"
    volumes:
      - /var/www/example.com:/var/www/example.com:ro
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - app
  app:
    image: php:8.3-fpm
    volumes:
      - /var/www/example.com:/var/www/example.com
    working_dir: /var/www/example.com

Переменные окружения и файл.env

Compose автоматически читает файл.env из каталога проекта и подставляет значения в compose.yaml через синтаксис ${ИМЯ}. Это удобно для паролей и тегов образов, которые не должны попадать в репозиторий. Значения из.env не передаются в контейнер сами по себе, для этого нужен ключ environment или env_file в описании сервиса.

yaml
services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: example
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

Безопасность при работе с Docker Compose

Контейнеры по умолчанию работают от root внутри образа, поэтому для php-fpm и nginx лучше указать пользователя с ограниченными правами. Порт базы данных не публикуйте на хост без необходимости: внутри сети Compose сервисы доступны по имени. Файл.env с паролями добавьте в.gitignore и не копируйте в образ. Для проверки итоговой конфигурации перед запуском используйте docker compose config.

yaml
services:
  app:
    image: php:8.3-fpm
    user: "1000:1000"
    volumes:
      - /var/www/example.com:/var/www/example.com

Типичные проблемы и их решение

Если docker compose up -d завершается ошибкой port is already allocated, значит порт уже занят другим процессом: проверьте ss -tlnp и измените публикацию порта. Ошибка no such file or directory для compose.yaml возникает, когда команда запущена не из каталога проекта. Контейнер сразу перезапускается, если в логах видна ошибка приложения: смотрите docker compose logs -f app.

bash
ss -tlnp | grep :80
docker compose logs -f app

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

  • Запуск docker compose up без флага -d оставляет процесс в терминале и блокирует сессию.

    Для фонового режима используйте docker compose up -d, а логи смотрите отдельно через docker compose logs -f.

  • Файл.env с паролями попадает в git, и секреты становятся доступны всем.

    Добавьте .env в .gitignore и передавайте значения через переменные окружения на сервере.

  • Порт 80 уже занят другим веб-сервером, и Compose выдаёт port is already allocated.

    Остановите конфликтующий сервис или измените левую часть проброса порта, например на 8080:80.

Deploykin

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

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

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

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

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

docker compose это плагин к Docker CLI, а docker-compose это отдельная утилита на Python. В Ubuntu 24.04 ставьте плагин docker-compose-plugin и используйте команду с пробелом.

Где Compose ищет файл конфигурации?

По умолчанию в текущем каталоге ищется compose.yaml или docker-compose.yml. Другой файл можно указать флагом -f, например docker compose -f /opt/app/compose.yaml up -d.

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

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

Сохраняются ли данные базы при docker compose down?

Да, если данные лежат в именованном томе. Тома удаляются только при явном указании флага -v: docker compose down -v.

Всё по теме Docker

Руководства по теме28

Готовые конфиги по теме1

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