В spring все очень продумано и много возможностей, как задать конфигурацию в разных случаях. Я тут всю доку пересказывать не буду (очень рекомендую ее просмотреть хотя бы чтоб понять, какие есть варианты в принципе и разобраться как происходит загрузка параметров конфигурации в принципе, т.е. порядок приоритетов). Я расскажу слегка упрощенно с прицелом на конкретный случай, т.е. то, что касается хранения параметров для локального тестирования.
Допустим в приложении вы используете параметр my.param
как-то так:
@Value("${my.param}")
String myParam;
В упрощенном виде для целей этого вопроса spring boot будет искать его в таком порядке:
- в аргументах командной строки (т.е. его нужно задавать как параметр приложению
java -jar myproject.jar --my.param=xyz
)
- системное свойство (т.е. параметр при запуске JVM
java -Dmy.param=xyz -jar myproject.jar
)
- переменная окружения процесса
- в
application-{profile}.properties
файле(-ах) в путях поиска конфигурации (об этом ниже)
- в
application-{profile}.properties
файле(-ах) запакованом в ваш jar
- в
application.properties
файле в путях поиска конфигурации
- в
application.properties
файле запакованом в ваш jar
- в файлах из
@PropertySource
аннотаций на ваших классах @Configuration
Что значит этот порядок? Это значит, что если вы задали свойство my.param
в трех местах, скажем в агрументах командной строки, в переменных окружения и в application.properties
, то в момент обращения к свойству spring возьмет его из командной строки, так как она выше в этом списке. Первое по порядку место, где задано значение, будет использовано.
Это открывает возможности гибко переопределять параметры.
Профили
Профили позволяют задать какие-то параметры конфигурации в отдельном файле. Какой профиль использовать определяется параметром spring.profiles.active
(на самом деле там можно задать несколько, но не хочу усложнять и так длинный ответ), который можно задать при старте приложения через командную строку, переменную окружения, системное свойство и т.д.
Пути поиска конфигурации
По умолчанию spring ищет файлы конфигурации (это нужно в пунктах 4-7 выше) в таком порядке:
- Поддиректория /config в текущей директории
- Текущая директория
- Директория /config в classpath
- В корне classpath
Это можно настроить, добавить дополнительные пути и т.д.
Конфигурации для разных окружений
Переменные окружения
Тут есть некоторое недопонимание, по-этому объясню.
Во-первых, чтоб использовать переменную окружения в spring boot вам не нужно писать чего-то типа в файле:
some.application.property = ${SOME_APPLICATOPN_PROPERTY}
В месте где вы используете это свойство, скажем через аннотацию @Value
spring boot автоматически прочитает значение из переменной окружения и будет его использовать вместо значения по умолчанию из application.properties
. Именно об этом говорит порядок поиска, который я в самом начале привел.
Далее, в переменных окружения нет ничего плохого. Они не являются глобальными или как вы их назвали системные переменные ОС
, если их вы их не cделаете такими. Это переменные окружения процесса. Тут вы путаете причину и следствие. Один из способов задания переменных окружения это задать их глобально для всех процессов ОС, и вы об этом, наверно, и говорите. Но это делать совсем необязательно.
Правильно делается это так. Создаете файл с нужными переменными, скажем local.params
.
my_param=xyz
other_param=abc
Обратите внимание, что в переменных окружения обычно нельзя использовать точки, по-этому их заменяем на подчеркивания, но в самом приложении использует их как обычно, т.е. my.param
и other.param
.
Теперь запускаем приложение (тут я предполагаю что у вас linux/unix, для windows я так понимаю, тоже можно подобным образом):
source local.params # читает переменные
export $(cut -d= -f1 local.params) # экспортирует переменные
java -jar myapp.jar
Тут эти переменные не являются глобальными переменными ОС, они установлены только для нашего процесса.
Профиль
Создайте файл application-local.properties
в одном из мест, где спринг ищет (см. выше), и в нем задайте параметры, которые хотите изменить. Все остальные будут браться из application.properties
. Запускайте приложение так:
java -jar myapp.jar --spring.profiles.active=local
Файлы конфигурации и git
Я бы не отметал сходу опцию хранения конфигурации для локального тестирования в системе контроля версия. В этом нет ничего плохого, это даже полезно. Вот приходит новый разработчик и ему не нужно искать, этот самый файл с опциями для локального запуска. Обычно там все равно пароли типа 123
или password
, т.е. ничего секретного да и данные в тестовой БД, а тем более локальной, вряд ли секретные.