Зачем
Один compose.yaml в git на прод и на тестовую машину. На тестовой нужен порт отладчика и LOG_LEVEL=debug.
Правка общего файла на месте мешает git pull или уезжает в прод следующим коммитом. Override лежит рядом,
в git не попадает (.gitignore) и меняет только то, что в нём написано.
Что получается из двух файлов
# compose.yaml
services:
app:
image: ghcr.io/example-user/app:latest
ports: ["8080:80"]
environment:
LOG_LEVEL: info
TZ: Etc/UTC
# compose.override.yaml
services:
app:
ports: ["127.0.0.1:9229:9229"]
environment:
LOG_LEVEL: debug
В итоге у app два порта, 8080 и 9229, LOG_LEVEL: debug и TZ: Etc/UTC. Правила такие:
| Что | Что получается |
|---|---|
значение: image, restart |
берётся из override |
карта: environment, labels |
ключи объединяются, совпавшие — из override |
ports |
складываются |
volumes |
по пути в контейнере: том override с тем же путём заменяет общий, остальные остаются |
Убрать унаследованное: !reset и !override
Сложение списков не даёт закрыть порт из общего файла. Для этого есть два тега:
services:
app:
ports: !reset [] # портов нет совсем
# ports: !override ["127.0.0.1:8080:80"] — только этот порт
environment:
TZ: !reset null # убрать одну переменную
Какие файлы читает стек
Без флагов — compose.yaml и, если есть, compose.override.yaml. -f compose.yaml читает только общий файл.
COMPOSE_FILE в .env задаёт список сам: COMPOSE_FILE=compose.yaml:compose.prod.yaml — и override тогда
не подхватывается.
Другая задача — подключить к стеку чужой compose-файл целиком, например базу из соседнего каталога. Это
include: в начале compose.yaml; относительные пути в подключённом файле считаются от его каталога.
Если не работает
Порт убрали из compose.yaml, а он по-прежнему открыт
- Причина
- Порт приходит из
compose.override.yaml: списки складываются, и порты override добавляются к общим. - Делаем
- Смотрим, какие файлы читает стек, —
docker compose ls, колонкаCONFIG FILES. Лишний override удаляем или убираем порт в нём.
Порт 8080 в override переписали на 127.0.0.1:8080:80, и up -d падает: failed to bind host port 127.0.0.1:8080/tcp: address already in use
- Причина
- Override не заменил порт, а добавил второй с тем же номером: compose публикует оба, и второй не встаёт.
- Делаем
ports: !override ["127.0.0.1:8080:80"]— список override заменяет общий целиком.
Задали COMPOSE_FILE в .env — настройки из override пропали
- Причина
- С
COMPOSE_FILEcompose читает только перечисленные файлы, override сам больше не подхватывается. - Делаем
- Добавляем его в список:
COMPOSE_FILE=compose.yaml:compose.override.yaml.
Как проверить
Какие файлы стек прочитал и что получилось из них вместе:
docker compose ls
# NAME STATUS CONFIG FILES
# app running(1) /opt/app/compose.yaml,/opt/app/compose.override.yaml
docker compose config