Миграция с 2.x на 3.0

В разработке

Руководство по миграции находится в процессе написания. Содержимое будет дополнено.

vanessa-runner 3.0 содержит несовместимые изменения относительно ветки 2.x. Ниже — краткий обзор того, что нужно поменять.

TL;DR — что менять

Что изменилось	Действие
Минимальная версия OneScript	Обновить до 2.0.0+
Состав и имена команд vrunner	Заменить переименованные/удалённые команды
Формат файла настроек	Привести vrunner.json к новой схеме autumn-properties.json
Имена переменных окружения	Переименовать RUNNER_* → VRUNNER_*

---

1. Повышена минимальная версия OneScript

Для работы 3.0 требуется OneScript не ниже 2.0.0 (в 2.x минимальная была 1.9.2).

# Проверить текущую версию
oscript -version

Обновить через ovm или с oscript.io.

---

2. Изменения в командах vrunner

Было (2.x)	Стало (3.0)	Комментарий
vrunner vanessa	vrunner test vanessa	переименована
vrunner updatedb	vrunner infobase update	функционал консолидирован
vrunner syntax-check	vrunner validate syntax-check	изменён набор ключей

---

3. Изменён формат файла настроек

Было (2.x) — плоский vrunner.json с ключами вида --ключ:

{
  "default": {
    "--ibconnection": "/F./build/ib",
    "--v8version": "8.3.24"
  },
  "xunit": {
    "--reportsxunit": "jUnit{./build/reports/junit.xml}"
  }
}

Стало (3.0) — иерархический autumn-properties.json без -- в ключах:

{
  "runner": {
    "ibconnection": "/F./build/ib",
    "v8version": "8.3.24",
    "test": {
      "xunit": {
        "reportsxunit": "jUnit{./build/reports/junit.xml}"
      }
    }
  }
}

TIP

Автоматическая конвертация vrunner.json → autumn-properties.json планируется в одном из ближайших релизов 3.0. До тех пор выполните миграцию вручную.

---

4. Переименованы переменные окружения

Переменные RUNNER_* переименованы в VRUNNER_* для устранения конфликтов с CI-окружениями (GitHub Actions, GitLab Runner и другими, где RUNNER_* зарезервированы системой).

WARNING

Обновите определения переменных в .gitlab-ci.yml, GitHub workflow-файлах, Jenkinsfile и shell-скриптах сборки.

---

Откат на 2.x

Если миграция занимает время — оставайтесь на LTS:

opm install vanessa-runner@2.6.1

Ветка release/2.6 продолжает получать багфиксы.

---

Помощь

Проблемы с миграцией — заводите issue.