Миграция с 2.x на 3.0
vanessa-runner 3.0 несовместим с 2.x: команды стали иерархическими, изменились имя и формат файла настроек, префикс переменных окружения. Ниже — порядок перехода и таблица соответствия команд; на страницах раздела каждая команда 2.x разобрана с примерами «было → стало».
Если переход откладывается, оставайтесь на ветке 2.6: opm install vanessa-runner@2.6.1.
Порядок миграции
- Обновите OneScript до 2.2.1 или новее (
oscript -version). - Установите 3.0:
opm install vanessa-runner. - Сконвертируйте файл настроек 2.x (
env.jsonв корне проекта или файл из--settings) вautumn-properties.jsonскриптомtools/migrate26to30.os(--input env.json) и разберите его предупреждения — Файл настроек и переменные окружения. - Переименуйте переменные окружения
RUNNER_*→VRUNNER_*в CI и скриптах сборки — таблица. - Замените вызовы
vrunnerпо таблице ниже. Опции в 3.0 указываются до позиционного аргумента:vrunner cf compile --src ./src ./build/1Cv8.cf.
Что изменилось
| Область | 2.x | 3.0 |
|---|---|---|
| Минимальная версия OneScript | 1.9.2 | 2.2.1 |
| Структура команд | Плоская: vrunner xunit | Иерархическая: vrunner test xunit |
| Корень проекта | --root (или --workspace), иначе корень git-репозитория: от него читался env.json и считались относительные пути | Рабочий каталог запуска |
| Файл настроек | env.json в корне проекта или файл из --settings (часто tools/vrunner.json) | autumn-properties.json |
| Ключи в файле настроек | "--option": "value" в секции команды | "option": "value" в объекте vrunner.<группа>.<команда> |
| Позиционные аргументы в файле настроек | Ключ по имени аргумента 2.x: xunit.testsPath, compileepf.inputPath | Ключ по имени аргумента 3.0: testspath, src, out; опция --out у compile стала аргументом OUT |
| Глобальные опции | --root, --bitness, --nocacheuse, --ibname, --debuglog, --debuglogfile | Удалены: вместо --ibname — --ibconnection, отладочный лог — уровень DEBUG логгера в autumn-properties.json (Уровни) |
| Переменные окружения | RUNNER_* | VRUNNER_* |
Таблица соответствия команд
| Команда 2.x | Команда 3.0 | Страница |
|---|---|---|
vrunner vanessa | vrunner test vanessa | vanessa |
vrunner xunit | vrunner test xunit <TESTSPATH> | xunit |
vrunner run | vrunner run enterprise | run |
vrunner designer | vrunner run designer | designer |
vrunner loadrepo | vrunner repo load | loadrepo |
vrunner init-dev | vrunner infobase init | init-dev |
vrunner update-dev | vrunner infobase update | init-dev |
vrunner updatedb | vrunner infobase update | updatedb |
vrunner update | vrunner cf vendor-update | update |
vrunner syntax-check | vrunner validate syntax-check | syntax-check |
vrunner compile | vrunner cf compile <OUT> | compile |
vrunner decompile | vrunner cf decompile <OUT> | decompile |
vrunner compileepf | vrunner epf compile [SRC] | compileepf |
vrunner decompileepf | vrunner epf decompile <SRC> | decompileepf |
vrunner compileext | vrunner cfe load [SRC] | compileext |
vrunner compileexttocfe | vrunner cfe compile <OUT> | compileext |
vrunner decompileext | vrunner cfe decompile <OUT> | decompileext |
vrunner session lock/unlock/kill/closed | vrunner cluster session lock/unlock/kill/closed | session |
vrunner scheduledjobs lock/unlock | vrunner cluster jobs lock/unlock | scheduledjobs |
vrunner init-project | нет аналога | init-project |
vrunner loadext | vrunner cfe load [SRC] | — |
vrunner unloadext | vrunner cfe unload <OUT> | — |
vrunner updateext | vrunner infobase update --target <имя> | — |
vrunner load | vrunner cf load [SRC] | — |
vrunner unload | vrunner cf unload <OUT> | — |
vrunner make-dist | vrunner cf make-dist <OUT> | — |
vrunner merge | vrunner cf merge | — |
vrunner compare | vrunner cf compare | — |
vrunner dump | vrunner infobase dump-dt <OUT> | — |
vrunner restore | vrunner infobase restore-dt <IN> | — |
vrunner create, vrunner remove | vrunner cluster create, vrunner cluster remove | — |
vrunner dbinfo | vrunner cluster info | — |
vrunner createrepo | vrunner repo create | — |
vrunner bindrepo | vrunner repo bind | — |
vrunner unbindrepo | vrunner repo unbind | — |
vrunner createrepouser | vrunner repo create-user | — |
vrunner copyrepouser | vrunner repo copy-user | — |
vrunner lockrepo | vrunner repo lock | — |
vrunner unlockrepo | vrunner repo unlock | — |
vrunner commit | vrunner repo commit | — |
vrunner unloadcfrepo | vrunner repo save-cf <OUT> | — |
vrunner edt-validate | vrunner validate edt | — |
vrunner set-version | нет аналога | — |
vrunner version | vrunner --version | — |
Остальные команды 3.0 отдельных страниц миграции не имеют — см. справочник команд:
| Группа | Команды 3.0 |
|---|---|
| cf | load, unload, make-dist, merge, compare, convert |
| cfe | load, unload, compare, convert |
| epf | convert |
| infobase | dump-dt, restore-dt, create-user, lock-resources, scheduled-job enable/disable, extensions list/check/create/delete/set-options |
| repo | create, bind, unbind, commit, lock, unlock, save-cf, create-user, copy-user |
| cluster | info, create, remove, session list |
| test | yaxunit |
| validate | edt |