Окружения
Редакция: OpenIDE Pro.
Адреса стендов и секреты не хранятся в скрипте: они лежат в файле connekt.env.json, а скрипт читает их через делегат by env. Один и тот же сценарий выполняется на local, staging и prod — меняется только выбранное окружение, а не текст запросов.
Объявление в скрипте
val host: String by env
val port: Int by env
val apiKey: String by env
Имя свойства — это ключ поиска в файле окружения. Если ключа нет, запуск завершится ошибкой.
Файл connekt.env.json
Верхний уровень файла — это имена окружений, внутри каждого лежат значения переменных:
{
"local": {
"host": "http://localhost:8080",
"port": 8080,
"apiKey": "local-dev-key"
},
"staging": {
"host": "https://staging.example.com",
"port": 443,
"apiKey": "staging-key"
}
}
Скрипт от этого не зависит: val host: String by env в обоих окружениях возьмёт свой host.
Типы переменных
Поддерживаются String, Int, Long, Double, Boolean.
Как выбирается окружение
В IDE окружение выбирается и правится через меню рядом с запуском сценария.
При запуске в контейнере файл и имя окружения передаются ключами --env-file и --env-name, а отдельные значения — ключом --env-param. Так значения для стенда можно взять из переменных CI, а не из репозитория.
Секреты
Файл окружения содержит секреты, поэтому решите заранее, попадает ли он в репозиторий. Рабочий подход: сценарии коммитятся и проходят код-ревью, файл окружения с реальными значениями остаётся локальным (или в секретах CI), а в репозитории лежит его пример с окружением для локального запуска.