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

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

Docker Compose входит в пакет docker-compose-plugin из официального репозитория Docker и ставится одной командой apt после подключения репозитория. На чистом Ubuntu 24.04 это занимает несколько минут: добавить ключ и репозиторий, установить docker-ce и плагин, описать сервисы в compose.yaml и запустить их. Проверка сводится к docker compose version и docker compose ps с запущенным контейнером.

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

01Обновите систему и поставьте зависимости

Начните с обновления списка пакетов и установки утилит, которые нужны для скачивания ключа и работы apt по HTTPS. Пакет ca-certificates обеспечивает проверку TLS при обращении к репозиторию Docker.

bash
sudo apt update
sudo apt install -y ca-certificates curl

02Добавьте ключ и репозиторий Docker

Ключ подписи кладётся в /etc/apt/keyrings, отдельный каталог для сторонних репозиториев. Затем в /etc/apt/sources.list.d/docker.list записывается строка репозитория с архитектурой и кодовым именем выпуска, которое подставляет $(. /etc/os-release && echo "$VERSION_CODENAME"). Для Ubuntu 24.04 это noble.

bash
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

03Установите Docker Engine и плагин Compose

Пакет docker-compose-plugin даёт команду docker compose как подкоманду Docker CLI. Отдельный бинарник docker-compose из репозитория Ubuntu не нужен, версия из apt обычно устарела. После установки проверьте версии движка и плагина.

bash
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version

04Разрешите запуск Docker без sudo

По умолчанию сокет /var/run/docker.sock доступен только root. Добавьте своего пользователя в группу docker и перезайдите в сессию, чтобы членство в группе применилось. Проверить можно командой docker ps без sudo.

bash
sudo usermod -aG docker $USER
newgrp docker
docker ps

05Создайте файл compose.yaml

Проект описывается в файле compose.yaml в каталоге проекта, например /var/www/example.com. В примере два сервиса: app на образе nginx и db на MySQL 8 с томом для данных. Пароль передаётся через переменную окружения, для рабочего сервера храните его в .env рядом с файлом.

yaml
services:
  app:
    image: nginx:1.27
    ports:
      - "80:80"
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: example_root_password
      MYSQL_DATABASE: example_db
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

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

Команда docker compose config разбирает файл, подставляет переменные и выводит итоговый конфиг. Если в YAML ошибка отступов или неизвестный ключ, вы увидите сообщение об ошибке до запуска контейнеров. Запускайте её из каталога с compose.yaml.

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

07Запустите сервисы

docker compose up -d скачивает образы, создаёт сеть и тома проекта и запускает контейнеры в фоне. Ключ -d возвращает управление в терминал, логи смотрите отдельно. Повторный запуск после правок в файле пересоздаёт изменившиеся контейнеры.

bash
docker compose up -d
docker compose ps

08Проверьте работу и посмотрите логи

docker compose ps показывает состояние контейнеров проекта, колонка STATUS должна содержать Up. Логи сервиса app выводятся командой docker compose logs -f app, ключ -f держит поток открытым. Зайти в контейнер можно через docker compose exec app sh, остановить и удалить всё командой docker compose down.

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

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

  • docker compose отвечает command not found, хотя Docker установлен.

    Не установлен пакет docker-compose-plugin. Поставьте его через sudo apt install -y docker-compose-plugin и проверьте docker compose version.

  • docker compose up падает с ошибкой permission denied while trying to connect to the Docker daemon socket.

    Пользователь не входит в группу docker. Выполните sudo usermod -aG docker $USER и перезайдите в сессию, членство в группе не применяется к уже открытой оболочке.

  • docker compose config ругается на YAML: mapping values are not allowed in this context или did not find expected key.

    Сломаны отступы: в YAML вложенность задаётся пробелами, табуляция запрещена. Выровняйте блоки двумя пробелами и снова запустите docker compose config.

  • Порт 80 занят, docker compose up пишет bind: address already in use.

    Порт слушает другой процесс, часто системный nginx или apache2. Остановите его через sudo systemctl stop nginx или смените публикацию порта в compose.yaml, например на "8080:80".

Deploykin

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

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

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

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

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

docker compose это плагин Docker CLI из пакета docker-compose-plugin, актуальная версия Compose v2. docker-compose это отдельный бинарник v1, который больше не развивается, его синтаксис и команды отличаются.

Как обновить Docker Compose на Ubuntu 24.04?

Выполните sudo apt update и затем sudo apt install --only-upgrade docker-compose-plugin. Версию после обновления покажет docker compose version.

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

В текущем каталоге: compose.yaml или compose.yml, устаревшее имя docker-compose.yml тоже поддерживается. Другой файл указывается ключом -f, например docker compose -f /var/www/example.com/compose.yaml up -d.

Что делает docker compose down и удаляет ли он данные?

Останавливает и удаляет контейнеры и сеть проекта. Именованные тома сохраняются, база в томе db_data останется на месте. Ключ -v удаляет и тома, данные пропадут.

Как пересобрать образы после изменения Dockerfile?

Запустите docker compose build, затем docker compose up -d, чтобы пересоздать контейнеры на новых образах. Свежие базовые образы подтягивает docker compose pull.

Ещё по теме

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

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