Dev-цикл: override, watch/sync, profiles и недрейфование от prod

Override-файлы: одна база, много окружений

Compose автоматически сливает два файла при их наличии: compose.yaml (базовое, общее, prod-образное определение) и compose.override.yaml (только локальные правки), с override, глубоко слитым поверх базы. Это механизм, позволяющий одному каноническому файлу описывать топологию, пока локальные заботы — debug-порт, bind mount, ослабленный уровень логов — живут в отдельном файле, который можно даже gitignore-нуть. У правил слияния есть senior-тонкость: отображения сливаются, но большинство последовательностей замещают. Две карты environment объединяются ключ-за-ключом; но command: или entrypoint: в override замещает базу целиком, а поля-списки вроде ports: конкатенируются именно для портов, тогда как многие другие списки замещают. Безопасная ментальная модель: скаляры и ключи override побеждают, карты глубоко сливаются, а всё списочное считай замещающим, пока не проверил. Можно быть явным через -f base.yaml -f dev.yaml, контролируя, какие файлы сливаются и в каком порядке — порядок важен, поздние файлы побеждают.

# compose.yaml — база, prod-образная, без монтирования исходников и debug-портов
services:
  api:
    build: .
    environment:
      LOG_LEVEL: info
    ports:
      - "8080:8080"

# compose.override.yaml — только локальный dev, глубоко слит поверх
services:
  api:
    environment:
      LOG_LEVEL: debug      # сливается в карту environment базы
    ports:
      - "9229:9229"          # порт дебаггера, конкатенируется с 8080
    develop:
      watch:
        - action: sync       # копировать изменённые файлы в работающий контейнер
          path: ./src
          target: /app/src
        - action: rebuild    # изменения здесь форсируют пересборку образа
          path: ./package.json

watch/sync против bind mount: живая перезагрузка без лжи

Старый быстрый цикл был bind mount исходников хоста поверх пути контейнера. Это мгновенно, но это ровно ловушка из Hook: каталог хоста замещает каталог контейнера, поэтому всё, что образ собрал в этот путь — node_modules, скомпилированные ассеты, venv — спрятано за файлами хоста, и dev тихо перестаёт запускать то, что содержит образ. develop.watch Compose — современная альтернатива, и она инвертирует модель: вместо монтирования хоста поверх контейнера она следит за путями хоста и реагирует на изменения. Действие sync копирует изменённые файлы в работающий контейнер (обычно меньше секунды, ~100–300ms для маленького файла) без затенения вывода сборки образа, так что hot-reloader внутри контейнера их подхватывает — быстрый цикл, но контейнер всё ещё запускает свои собранные зависимости. Действие rebuild для изменений, которые нельзя горячо пропатчить: правишь package.json или Dockerfile, и watch пересобирает образ и пересоздаёт контейнер (секунды-десятки секунд в зависимости от кеша). Вариант sync+restart копирует, затем перезапускает процесс для кода, которому нужен чистый рестарт, а не hot reload. Дисциплина, которую это даёт: dev запускает реальный образ с явным, видимым синком исходников — install-шаг выполняется при каждом изменении зависимостей, а не гниёт.

Profiles: опциональные сервисы выключены по умолчанию

Большой стек часто несёт сервисы, нужные не всем каждый день — стек метрик, mail-catcher, засеянная тестовая фикстура, admin-UI. Помещение их в базовый файл значит, что каждый платит их стоимость старта и след по ресурсам на каждом up. Profiles прячут сервис так, что он стартует только когда его профиль явно активирован: сервис с тегом profiles: ["debug"] не стартует на обычном compose up; он стартует только с --profile debug или когда назван напрямую. Сервисы без ключа profiles стартуют всегда — это твой ядровый набор. Senior-подвох — взаимодействие зависимостей: если всегда-включённый сервис depends_on профилированный, профилированный подтягивается неявно для удовлетворения зависимости, что может удивить запуском того, что ты считал выключенным. Profiles держат дефолтный up лёгким — поднять три реально нужных сервиса за пару секунд — сохраняя опциональные восемь в одном флаге, всё в одном файле. Альтернатива, отдельные compose-файлы под сценарий, фрагментирует топологию и переоткрывает дрейф; profiles держат один файл единственным источником истины.