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

Docker Compose file на Ubuntu 24.04: пошаговая настройка

Compose-файл описывает сервисы проекта: образы, порты, тома и переменные окружения. На Ubuntu 24.04 файл называется compose.yaml и запускается командой docker compose up -d.

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

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

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

bash
docker compose version

02Создайте каталог проекта и файл.env

Проект размещают в отдельном каталоге, например /var/www/example.com. Пароль базы и другие секреты хранят в файле .env рядом с compose.yaml: Compose подставляет их в конфиг через ${ИМЯ}. Сам .env не коммитят в репозиторий.

bash
mkdir -p /var/www/example.com
cd /var/www/example.com
printf 'MYSQL_ROOT_PASSWORD=example_root_password\nMYSQL_DATABASE=app\n' > .env
chmod 600 .env

03Напишите compose.yaml

Ключ version: в Compose v2 устарел и даёт только предупреждение, поэтому его не пишут. Сервисы видят друг друга по имени сервиса в сети <проект>_default: приложение обращается к базе как db:3306, а не localhost. Порт базы публикуют только на localhost сервера: 127.0.0.1:3306:3306, потому что опубликованные порты Docker обходят UFW.

yaml
services:
  app:
    image: php:8.3-fpm
    volumes:
      - ./app:/var/www/html
    depends_on:
      - db

  web:
    image: nginx:1.24
    ports:
      - "80:80"
    volumes:
      - ./app:/var/www/html
    depends_on:
      - app

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
    volumes:
      - db_data:/var/lib/mysql
    ports:
      - "127.0.0.1:3306:3306"

volumes:
  db_data:

04Проверьте файл командой docker compose config

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

bash
docker compose config

05Запустите проект

Команда docker compose up -d скачивает образы и поднимает контейнеры в фоне. Если порт 80 уже занят nginx самого сервера, появится Bind for 0.0.0.0:80 failed: port is already allocated. Кто держит порт, показывает sudo ss -ltnp: остановите службу или смените публикуемый порт в файле.

bash
docker compose up -d
docker compose ps

06Проверьте работу стека

docker compose ps показывает запущенные сервисы и их состояние. Логи приложения смотрят командой docker compose logs -f app, оболочку внутри контейнера открывают через docker compose exec app sh. Запрос к сайту проверяет, что nginx отвечает, а подключение к базе из контейнера app по адресу db:3306 подтверждает работу сети проекта.

bash
curl -I http://203.0.113.10/
docker compose exec app sh -c 'php -r "new PDO(\"mysql:host=db;port=3306;dbname=app\", \"root\", getenv(\"MYSQL_ROOT_PASSWORD\")); echo \"ok\";"'

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

  • В compose.yaml пароль базы записан прямо в environment, и файл с секретом попадает в репозиторий.

    Храните пароль в .env и подставляйте его как ${MYSQL_ROOT_PASSWORD}. Файл .env добавьте в .gitignore.

  • Приложение обращается к базе по localhost:3306 и получает отказ в соединении.

    Внутри сети проекта адрес базы это имя сервиса: db:3306. localhost внутри контейнера app указывает на сам app.

  • После docker compose down пропали данные базы.

    Данные в именованном томе переживают docker compose down, но удаляются командой docker compose down -v. Не запускайте её на рабочем проекте.

  • Контейнер падает с кодом выхода 137.

    Код 137 значит, что процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Проверьте docker compose logs app и лимиты памяти на сервере.

Deploykin

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

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

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

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

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

Compose v2 по умолчанию ищет compose.yaml, но старое имя docker-compose.yml тоже читается. Содержимое файлов одинаковое, ключ version: в начале больше не нужен.

Как передать переменные окружения в compose-файл?

Положите их в файл .env рядом с compose.yaml и укажите в сервисе как ${ИМЯ}. Compose подставит значения при запуске, проверить результат можно командой docker compose config.

Почему порт базы опубликован как 127.0.0.1:3306:3306?

Опубликованные порты Docker обходят UFW, поэтому порт, открытый на 0.0.0.0, доступен из интернета. Привязка к 127.0.0.1 оставляет базу доступной только с самого сервера.

Где хранятся данные MySQL после перезапуска контейнера?

В именованном томе db_data, он подключён к /var/lib/mysql. Том сохраняется при docker compose down и удаляется только с флагом -v.

Ещё по теме

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

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