Миграция с 2.x на 3.0
vanessa-runner 3.0 — мажорный релиз с несовместимыми изменениями относительно ветки 2.x. Поменялись структура команд (vrunner стал иерархическим), формат файла настроек и префиксы переменных окружения. Этот раздел проведёт вас через переход шаг за шагом: ниже — общий порядок действий и сводные таблицы, а на отдельных страницах каждая команда 2.x разобрана с конкретными примерами «было → стало».
Кому это нужно
- Переходите с 2.x на 3.0 — да, миграция обязательна: старые команды, формат
vrunner.jsonи переменныеRUNNER_*в 3.0 не работают без изменений. - Остаётесь на 2.x — ничего делать не нужно. LTS-ветка 2.6 продолжает получать исправления (см. Откат на 2.x).
- Начинаете новый проект на 3.0 — этот раздел можно пропустить и сразу перейти к Началу работы.
Порядок миграции
Рекомендуемая последовательность шагов. Большинство проектов мигрирует за один подход.
- Обновите OneScript до
2.0.0+— это требование 3.0 (в 2.x минимальной была1.9.2). Проверка:oscript -version. - Установите 3.0 —
opm install vanessa-runner(или@snapshotдля тестирования). - Сконвертируйте файл настроек — переименуйте
vrunner.jsonвautumn-properties.jsonи приведите его к новой схеме. Удобнее всего скриптом конвертации (см. блок ниже и Файл настроек и переменные окружения →). - Переименуйте переменные окружения
RUNNER_*→VRUNNER_*в CI-файлах и скриптах сборки (таблица соответствия →). - Обновите вызовы
vrunnerв скриптах сборки по таблице соответствия команд ниже. - Прогоните сборку и сверьтесь с предупреждениями — vrunner подскажет, какие ключи настроек требуют правки.
Скрипт автоматической конвертации
Для конвертации vrunner.json в autumn-properties.json используйте:
oscript tools/migrate26to30.os --input vrunner.json --output autumn-properties.jsonПодробнее: Файл настроек и переменные окружения →
Что изменилось
| Область | 2.x | 3.0 |
|---|---|---|
| Минимальная версия OneScript | 1.9.2 | 2.0.0+ |
| Структура команд | Плоская | Иерархическая |
| Файл настроек | vrunner.json | autumn-properties.json |
| Ключи в файле настроек | "--option": "value" | "option": "value" |
| Иерархия настроек | Плоские секции | Вложенные runner.<cmd>.<sub> |
| Переменные окружения | RUNNER_* | VRUNNER_* |
Таблица соответствия команд
| Команда 2.x | Команда 3.0 | Страница миграции |
|---|---|---|
vrunner vanessa | vrunner test vanessa | → |
vrunner xunit | vrunner test xunit | → |
vrunner run | vrunner run enterprise | → |
vrunner loadrepo | vrunner repo load | → |
vrunner init-dev | vrunner infobase init | → |
vrunner update-dev | vrunner infobase update | → |
vrunner updatedb | vrunner infobase update | → |
vrunner syntax-check | vrunner validate syntax-check | → |
vrunner compile / vrunner compileconf | vrunner cf compile <OUT> | → |
vrunner decompile / vrunner decompileconf | vrunner cf decompile <OUT> | → |
vrunner compileepf | vrunner epf compile | → |
vrunner decompileepf | vrunner epf decompile | → |
vrunner compileext | vrunner cfe compile <OUT> | → |
vrunner decompileext | vrunner cfe decompile <OUT> | → |
vrunner designer | vrunner run designer | → |
vrunner session lock/unlock/kill | vrunner cluster session lock/unlock/kill | → |
vrunner scheduledjobs lock/unlock | vrunner cluster jobs lock/unlock | → |
vrunner init-project | (удалена) | → |
Обновление файла настроек
Подробное описание изменений формата настроек, полная таблица переменных окружения и скрипт автоматической конвертации: →
Откат на 2.x
Если миграция занимает время — оставайтесь на LTS-ветке 2.6:
opm install vanessa-runner@2.6.1Ветка release/2.6 продолжает получать патчи с исправлениями ошибок.