Docker Compose file на Ubuntu 24.04: пошаговая настройка
Compose-файл описывает сервисы проекта: образы, порты, тома и переменные окружения. На Ubuntu 24.04 файл называется compose.yaml и запускается командой docker compose up -d.
01Проверьте, что плагин Compose установлен
Docker Compose v2 это плагин к Docker, команда пишется через пробел: docker compose. Старый бинарник docker-compose не поддерживается с 2023 года. Если плагина нет, установите пакет docker-compose-plugin из репозитория Docker, как описано в инструкции по установке Docker Compose.
docker compose version
02Создайте каталог проекта и файл.env
Проект размещают в отдельном каталоге, например /var/www/example.com. Пароль базы и другие секреты хранят в файле .env рядом с compose.yaml: Compose подставляет их в конфиг через ${ИМЯ}. Сам .env не коммитят в репозиторий.
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.
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 запрещена.
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: остановите службу или смените публикуемый порт в файле.
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 подтверждает работу сети проекта.
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 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: руководство по работе с многоконтейнерными приложениями: все материалы темы