admin/.wiki/concepts/config-custom-env-mapping-in-mounted-dirs.md

title, status, tags

title	status	tags
config-custom-env-mapping-in-mounted-dirs — env бесполезен без mapping-файла	live	config npm-config env books gotcha

npm config + примонтированный конфиг-дир: env читается только через custom-environment-variables.json

Проблема (2026-08-23, деплой books)

Код читает config.get('sched') (npm-пакет config), env-mapping — config/custom-environment-variables.json ("sched": {"adminUrl": "SCHED_ADMIN_URL", ...}). В контейнерах books (api/web/task-runner) конфиг-дир — примонтированный (bind /opt/books/*/config или named volume), и в нём НЕ было custom-environment-variables.json (только default.json) → config.get('sched') THROW: "Configuration property sched is not defined", даже с env-переменными в стеке.

Причина: маунт затеняет файлы из образа; env-mapping работает только если mapping-файл лежит в РАБОЧЕМ конфиг-дире (mounted), не в образе.

Фикс

Положить custom-environment-variables.json (с sched-mapping) в каждый примонтированный конфиг-дир:

• slovo: /opt/books/api/config/, /opt/books/task-runner/config/ (host binds)
• volumes: books-web-config, bookva-api-config, bookva-web-config, bookva-task-runner-config — через docker run --rm -v <vol>:/c -v /tmp:/tmp:ro alpine cp /tmp/file /c/

Нюансы:

• mapping не создаёт свойство, если его нет в файлах И env-переменная отсутствует: config.get('sched') бросит. Нужны оба: mapping-файл + env в стеке.
• config кэшируется на старте процесса — после правки файлов контейнер нужно пересоздать (redeploy).
• Проверка: docker exec <ctr> sh -c 'cd /usr/src/app/packages/<svc> && node -e "console.log(JSON.stringify(require(\"config\").get(\"sched\")))"' (cwd ВАЖЕН — конфиг резолвится от него; cd /usr/src/app/packages/* ломается на multi-dir).