Текст и данные · Инструкция
Как включать опциональные сервисы через Docker Compose profiles
Profiles удобны для debug, admin и test-сервисов, которые не должны подниматься при каждом `up`.
Короткий ответ
Добавьте сервису `profiles: [debug]` и запускайте стек через `docker compose --profile debug up`. Сервисы без profiles стартуют обычно.
Порядок действий
- Назначьте profile только опциональным сервисам.
- Запустите нужный профиль через `--profile`.
- Для нескольких профилей повторите флаг или задайте `COMPOSE_PROFILES`.
- Проверьте активные сервисы через `docker compose ps`.
Перед завершением проверьте
- Основные сервисы не спрятаны за профилем.
- Имена profiles отражают назначение.
Важно
Явный запуск сервиса с profile может запустить его без предварительного включения profile; учитывайте это в скриптах.
Что учитывать
Явный запуск сервиса с profile может запустить его без предварительного включения profile; учитывайте это в скриптах.
Источники и проверка
Фактическая часть сверена по первичным источникам (в т.ч. Using profiles with Compose). Пример и формулировки — редакция N1RO на 2026-09-20.