Переменные окружения
Часть опций и аргументов можно задать переменными окружения - удобно в CI, где параметры подключения нежелательно передавать в командной строке. Переменная опции показана в справке команды (vrunner <команда> --help, пометка env $VRUNNER_...).
Переменная окружения слабее аргумента командной строки и сильнее файла настроек. Флаги включаются значением true.
Подключение к ИБ
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_IBCONNECTION | --ibconnection | Строка подключения (/F<путь> или /S<сервер>\<база>) |
VRUNNER_DBUSER | --db-user | Пользователь информационной базы |
VRUNNER_DBPWD | --db-pwd | Пароль пользователя ИБ |
Платформа
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_V8VERSION | --v8version | Версия платформы 1С |
VRUNNER_UCCODE | --uccode | Код разрешения |
VRUNNER_LANGUAGE | --language | Язык платформы |
VRUNNER_LOCALE | --locale | Язык сеанса (локаль) |
СУБД
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_DBMS_TYPE | --dbms-type | Тип СУБД: MSSQLServer, PostgreSQL, IBMDB2, OracleDatabase |
VRUNNER_DBMS_SERVER | --dbms-server | Адрес сервера СУБД |
VRUNNER_DBMS_BASE | --dbms-base | Имя базы данных СУБД |
VRUNNER_DBMS_USER | --dbms-user | Пользователь СУБД |
VRUNNER_DBMS_PWD | --dbms-pwd | Пароль СУБД |
Хранилище конфигурации
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_STORAGE_NAME | --storage-name | Адрес хранилища |
VRUNNER_STORAGE_USER | --storage-user | Пользователь хранилища |
VRUNNER_STORAGE_PWD | --storage-pwd | Пароль хранилища |
VRUNNER_STORAGE_VER | --storage-ver | Номер версии хранилища |
Кластер серверов
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_RAS | --ras | Адрес RAS (по умолчанию localhost:1545) |
VRUNNER_RAC | --rac | Путь к утилите rac |
VRUNNER_IBNAME | --db-name | Имя ИБ в кластере |
VRUNNER_CLUSTERADMIN_USER | --cluster-admin | Администратор кластера |
VRUNNER_CLUSTERADMIN_PWD | --cluster-pwd | Пароль администратора кластера |
Запуск клиента
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_ORDINARYAPP | --ordinaryapp | Толстый клиент: 1/true |
VRUNNER_ADDITIONAL | --additional | Дополнительные параметры запуска платформы (также run designer) |
VRUNNER_IBSRV | --ibsrv | Запускать через автономный сервер ibsrv (только файловые ИБ) |
VRUNNER_IBSRV_DIRECT | --ibsrv-direct | Прямое соединение с ibsrv вместо WS |
VRUNNER_IBSRV_DEBUG | --ibsrv-debug | Включить порт отладки ibsrv |
VRUNNER_IBSRV_ATTACH | --ibsrv-attach | Подключиться к уже запущенному ibsrv |
VRUNNER_IBSRV_PORT | --ibsrv-port | Порт ibsrv |
VRUNNER_COMMAND | --command | Параметр запуска /C (run enterprise) |
VRUNNER_EXECUTE | --execute | Внешняя обработка для запуска (run enterprise) |
Исходники и файлы
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_SRC | --src | Каталог исходников: cf compile, cf convert, cfe compile, cfe convert, epf convert, validate edt |
VRUNNER_SOURCE | --src | Источник конфигурации: infobase init, infobase update |
VRUNNER_CF_OUT | OUT | Файл .cf для cf compile |
VRUNNER_CFE_OUT | OUT | Файл .cfe для cfe compile |
VRUNNER_CF_FILE | --cf-file | Файл .cf для cf decompile |
VRUNNER_CFE_FILE | --cfe-file | Файл .cfe для cfe decompile |
VRUNNER_EXTENSION_NAME | --extension-name | Имя расширения: cfe compile, cfe decompile, cfe load, cfe unload |
EDT
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_EDT_PATH | --edt-path | Путь к 1cedtcli или каталогу установки EDT |
VRUNNER_EDT_VERSION | --edt-version | Версия EDT для выбора среди установленных |
VRUNNER_EDT_WORKSPACE | --edt-workspace | Базовый каталог рабочей области EDT |
VRUNNER_EDT_TIMEOUT | --edt-timeout | Таймаут операций 1cedtcli, сек |
VRUNNER_EDT_VMARGS | --edt-vmargs | Дополнительный JVM-аргумент для 1cedtcli |
Тестирование
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_TESTSPATH | TESTSPATH | Путь к тестам test xunit |
VRUNNER_PATHXUNIT | --pathxunit | Путь к xddTestRunner.epf |
VRUNNER_CONFIG_TESTS | --config-tests | Загружать тесты, встроенные в конфигурацию |
VRUNNER_FEATUREPATH | --feature-path | Путь к фичам test vanessa |
VRUNNER_PATHVANESSA | --bddrunner-path | Путь к bddRunner.epf |
VRUNNER_VANESSASETTINGS | --vanessasettings | Путь к настройкам Vanessa |
VRUNNER_WORKSPACE | --workspace | Папка проекта: test xunit, test vanessa, test yaxunit |
VRUNNER_YAXUNIT_CONFIG | --yaxunit-config | Готовый yaxunit.json |
VRUNNER_YAXUNIT_EXT | --ext | Расширения с тестами YAxUnit |
VRUNNER_YAXUNIT_EXITCODE | --exitcode | Файл кода возврата test yaxunit |
VRUNNER_PROJECT_PATH | --project-path | Каталог проекта для test yaxunit |
Отчёты и покрытие
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_REPORT_PATH | --report-path | Куда выгрузить отчёт (подробнее) |
VRUNNER_COVERAGE_REPORT | --coverage-report | Файл отчёта покрытия; задан - покрытие включено (подробнее) |
VRUNNER_COVERAGE_FORMAT | --coverage-format | Формат отчёта покрытия |
VRUNNER_COVERAGE_SRC | --coverage-src | Каталог исходников конфигурации для сопоставления модулей |
VRUNNER_COVERAGE_SERVER | --coverage-server | Сервер отладки [хост:]порт |
VRUNNER_COVERAGE_DBGS | --coverage-dbgs | Путь к dbgs |
VRUNNER_COVERAGE_ALIAS | --coverage-alias | Имя ИБ для сессии отладки |
VRUNNER_COVERAGE_DEBUG_PWD | --coverage-debug-pwd | Пароль сервера отладки |
VRUNNER_COVERAGE_SKIP_LINES | --coverage-skip-lines | Не рассчитывать покрываемые строки |
Устаревшие переменные отчётов продолжают работать: VRUNNER_JUNITPATH (--junitpath), VRUNNER_ALLURE_RESULTS (--allure-results), VRUNNER_REPORTSXUNIT (--reportsxunit), VRUNNER_YAXUNIT_REPORT (--report в test yaxunit), VRUNNER_EDT_REPORT (--report в validate edt). Замена - --report-format и --report-path. Формат отчёта переменной окружения не имеет.
Настройки и лог
| Переменная | Опция | Описание |
|---|---|---|
VRUNNER_SETTINGS | --settings | Путь к файлу настроек (JSON); файл обязан существовать |
VRUNNER_LOG_OUTPUT | - | Куда писать лог: stdout (по умолчанию) или stderr, см. Потоки вывода |
Ключи файла настроек через окружение
Любой ключ файла настроек можно задать переменной окружения: имя ключа в верхнем регистре, точки заменены на _. Так задаются опции, у которых нет своей переменной, например флаг --ibcmd:
bash
export VRUNNER_IBCMD=true # vrunner.ibcmd - для всех команд
export VRUNNER_CF_COMPILE_OUT=./build/App.cf # vrunner.cf.compile.outТакая переменная действует, только если тот же ключ не задан ни в одном файле настроек: значение из файла сильнее. Для опций с дефисом в имени (db-user) используйте их собственные переменные.
Пример для CI
bash
export VRUNNER_IBCONNECTION="/S1c-server\MyBase"
export VRUNNER_DBUSER=Admin
export VRUNNER_DBPWD=$SECRET_IB_PWD
export VRUNNER_V8VERSION=8.3.24
export VRUNNER_IBCMD=true
export VRUNNER_DBMS_TYPE=PostgreSQL
export VRUNNER_DBMS_SERVER=pg.internal
export VRUNNER_DBMS_BASE=my_db
export VRUNNER_DBMS_USER=postgres
export VRUNNER_DBMS_PWD=$SECRET_PG_PWD
vrunner infobase update --src ./build/MyApp.cf
vrunner test xunit --report-format junit --report-path ./build/reports/junit.xml ./tests