basforge

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

    EN

    .env — для подстановки в compose, env_file — внутрь контейнера

    .env рядом с compose нужен для подстановки ${…} в сам compose-файл. env_file: .env вдобавок отдаёт всё его содержимое внутрь контейнера, поэтому ставим его, только если контейнеру нужны все эти переменные.

    Что уезжает в контейнер

    .env compose читает сам и подставляет значения в файл. Внутрь контейнера из него не попадает ничего, пока не написано env_file: .env. С env_file в окружение контейнера уезжает всё: хэши паролей, ключи соседних сервисов, домены. И каждая новая строка в .env меняет окружение контейнера, а значит, пересоздаёт его («Хэш конфига compose»).

    Типичный случай: хэш Basic Auth из .env нужен только лейблу Traefik, а через env_file попадает и внутрь приложения. Убираем env_file — лейбл по-прежнему получает значение:

    services:
      app:
        # env_file: .env    — убрали: внутрь уезжал весь .env
        labels:
          - "traefik.http.middlewares.app-auth.basicauth.users=${APP_AUTH}"   # значение подставит compose

    Если не работает

    Добавили строку в .env — пересоздался контейнер, которому она не нужна

    Причина
    У контейнера env_file: .env: каждая новая строка меняет его окружение, а значит, и итоговый конфиг.
    Делаем
    Убираем env_file и передаём контейнеру только нужное — через environment:.

    Как проверить

    Смотрим, какие переменные видит контейнер, — только имена, без значений:

    docker compose exec app env | cut -d= -f1 | sort

    В списке не должно быть переменных, которые приложению не нужны.