basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Своё для одной машины — в compose.override.yaml

    Compose сам читает compose.override.yaml рядом с compose.yaml и накладывает его поверх. Туда кладём то, что есть только на этой машине — отладочный порт, другой уровень логов, — а общий файл в git не трогаем.

    Зачем

    Один 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_FILE compose читает только перечисленные файлы, 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