n1ro°
RU

Текст и данные · Инструкция

Как использовать configs в Docker Compose

Configs удобны для несекретных настроек, которые приложение читает из файла и которые не стоит запекать в образ.

Редакция N1RO · Проверено

Короткий ответ

Опишите конфиг в top-level `configs`, затем явно подключите его к нужному service через `configs`. Compose смонтирует конфигурационные данные как файл без пересборки image.

Что делать

  1. Создайте локальный конфигурационный файл, например `app.conf`.
  2. В top-level `configs` объявите источник `file: ./app.conf`.
  3. В нужном service добавьте секцию `configs` и имя конфигурации.
  4. При необходимости задайте target-путь длинным синтаксисом.
  5. Выполните `docker compose config` и проверьте модель.
  6. Запустите service и убедитесь, что файл доступен по ожидаемому пути.

Важно

  • Для паролей и токенов используйте secrets, а не configs.

Что учитывать

Для паролей и токенов используйте secrets, а не configs.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Configs top-level element). Пример и формулировки — редакция N1RO на 2026-09-18.