О проекте

vanessa-runner - CLI-инструмент для автоматизации повседневных задач разработчиков 1С:Предприятие.

Что это такое?

Vanessa-runner предоставляет единый интерфейс командной строки для выполнения типовых операций в 1С-проектах:

сборка конфигураций, расширений и обработок из XML-исходников и обратно;
создание, обновление и бэкап информационных баз;
работа с хранилищем конфигурации;
управление кластером серверов;
запуск тестов (xUnit и BDD/Vanessa-ADD);
проверка синтаксиса конфигурации;
запуск 1С:Предприятия и Конфигуратора.

Архитектура

Начиная с версии 3.0 инструмент полностью переписан на базе фреймворка Autumn для OneScript. Это обеспечивает:

иерархический синтаксис команд: vrunner <группа> <подкоманда>;
каскад настроек через autumn-properties.json и переменные окружения;
внедрение зависимостей между сервисами.

Группы команд

Команда	Описание
`cf`	Операции с конфигурацией (.cf)
`cfe`	Операции с расширениями (.cfe)
`epf`	Операции с обработками (.epf/.erf)
`infobase`	Управление информационными базами
`repo`	Работа с хранилищем конфигурации
`cluster`	Управление кластером серверов
`run`	Запуск 1С в разных режимах
`test`	Запуск тестов
`validate`	Проверка конфигурации

Поддержка

Telegram: vanessa_opensource_chat
GitHub Issues: vanessa-runner/issues

Подключение к базе данных

Большинство команд vanessa-runner работают с информационной базой 1С. На этой странице объясняется, как указать нужную базу и когда какие опции подключения нужны.

Строка подключения (--ibconnection)

Опция --ibconnection указывает, к какой базе подключиться.

Файловая ИБ:

bash

--ibconnection /F<путь>

Примеры: --ibconnection /F./ib, --ibconnection /FD:/bases/MyProject

Серверная ИБ (1С:Сервер предприятия):

bash

--ibconnection "/S<хост>\<имя-ИБ>"

Пример: --ibconnection "/SMyServer\MyInfobase"

Учётные данные ИБ

--db-user и --db-pwd - пользователь и пароль, созданные в 1С (не пользователь ОС или СУБД). Если база не требует аутентификации - можно не указывать.

Конфигуратор или ibcmd?

По умолчанию vanessa-runner использует Конфигуратор (1cv8.exe DESIGNER).

Флаг --ibcmd переключает на утилиту ibcmd, которая работает напрямую с файлами базы без запуска сервера. Это быстрее и удобнее в CI/CD.

	Конфигуратор	ibcmd
Нужен работающий кластер	Для серверных ИБ	Нет
СУБД-опции для серверной ИБ	Не нужны	Нужны
Скорость	Стандартная	Быстрее

Когда нужны опции СУБД (--dbms-*)

--dbms-type, --dbms-server, --dbms-base, --dbms-user, --dbms-pwd нужны в одном случае:

ibcmd + серверная ИБ:
ibcmd подключается к СУБД напрямую, минуя 1С-сервер - нужны учётные данные СУБД.

TIP

Для файловых баз или при работе через Конфигуратор опции --dbms-* не нужны.

Когда база необязательна (временная ИБ)

Некоторые команды работают без готовой базы - они автоматически создают временную ИБ, выполняют операцию и удаляют её:

Команда	Поведение без `--ibconnection`
`cf compile`, `cfe compile`, `epf compile`	Создаётся временная файловая ИБ (удаляется после)
`cf decompile`, `cfe decompile`, `epf decompile`	То же самое
`infobase init`	Создаётся файловая ИБ в `build/ib` (не удаляется)

Для всех остальных команд --ibconnection обязателен.

Примеры

Файловая ИБ

bash

vrunner cf load ./src \
  --ibconnection /F./ib \
  --db-user Admin \
  --db-pwd secret

Серверная ИБ через Конфигуратор

bash

vrunner cf load ./src \
  --ibconnection "/SMyServer\MyIB" \
  --db-user Admin \
  --db-pwd secret

Серверная ИБ через ibcmd

bash

vrunner cf compile ./build/App.cf \
  --ibcmd \
  --ibconnection "/SMyServer\MyIB" \
  --dbms-type PostgreSQL \
  --dbms-server db.example.com \
  --dbms-base my_db \
  --dbms-user postgres \
  --dbms-pwd db_password

Без базы (временная ИБ)

bash

# ibcmd создаёт и удаляет временную базу автоматически
vrunner cf compile ./build/App.cf --ibcmd

Загрузка в существующую серверную ИБ через ibcmd

WARNING

infobase init не создаёт серверную ИБ. Создайте базу заранее - через консоль кластера 1С или ibcmd infobase create, затем загрузите конфигурацию:

bash

vrunner infobase init \
  --ibconnection "/SMyServer\MyNewIB" \
  --ibcmd \
  --dbms-type MSSQLServer \
  --dbms-server sql.example.com \
  --dbms-base MyNewDB \
  --dbms-user sa \
  --dbms-pwd secret \
  --source ./build/App.cf

cf - Операции с конфигурацией

Группа команд cf обеспечивает работу с конфигурацией 1С: сборку из исходников, разборку, загрузку в базу, выгрузку, объединение и сравнение.

bash

vrunner cf <подкоманда> [аргументы] [опции]

compile

Собирает конфигурацию 1С из XML-исходников в файл .cf.

bash

vrunner cf compile <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому файлу конфигурации (`.cf`)

Опции

Опция	Переменная окружения	Описание
`--s`, `--src`	`VRUNNER_SRC`	Каталог исходников конфигурации (по умолчанию - текущий каталог)
`--list`	-	Список файлов для выборочной загрузки
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Собрать конфигурацию с помощью ibcmd
vrunner cf compile ./build/MyApp.cf --s ./src --ibcmd

# Собрать через конфигуратор с указанием базы
vrunner cf compile ./build/MyApp.cf \
  --s ./src \
  --ibconnection /FD:/bases/MyProject \
  --v8version 8.3.24

decompile

Разбирает файл конфигурации .cf в XML-исходники.

bash

vrunner cf decompile <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Каталог для выгрузки исходников конфигурации

Опции

Опция	Переменная окружения	Описание
`--cf-file`	`VRUNNER_CF_FILE`	Путь к CF-файлу для разборки (обязательный)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Разобрать CF в исходники
vrunner cf decompile ./src --cf-file ./build/MyApp.cf --ibcmd

# Через конфигуратор
vrunner cf decompile ./src \
  --cf-file ./MyApp.cf \
  --ibconnection /FD:/bases/temp \
  --v8version 8.3.24

load

Загружает конфигурацию в информационную базу из XML-исходников или CF-файла.

bash

vrunner cf load <SRC> [опции]

Аргументы

Аргумент	Описание
`SRC`	Каталог исходников конфигурации или путь к CF-файлу

Опции

Опция	Переменная окружения	Описание
`--list`	-	Список файлов для выборочной загрузки
`--increment`	-	Инкрементальная загрузка по индексу изменений
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Загрузить конфигурацию из исходников
vrunner cf load ./src --ibconnection /F./ib

# Инкрементальная загрузка
vrunner cf load ./src --ibconnection /F./ib --increment

unload

Выгружает конфигурацию из информационной базы в CF-файл.

bash

vrunner cf unload <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому CF-файлу (обязательный)

Опции

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner cf unload ./backup/MyApp.cf --ibconnection /F./ib

merge

Объединяет конфигурацию из CF-файла с конфигурацией информационной базы согласно файлу настроек.

bash

vrunner cf merge [опции]

Опции

Опция	Описание
`--s`, `--src`	Путь к CF-файлу с конфигурацией для объединения (обязательный)
`--merge-settings`	Путь к файлу настроек объединения (обязательный)
`--enable-support`	Поставить конфигурацию на поддержку
`--disable-support`	Снять конфигурацию с поддержки
`--IncludeObjectsByUnresolvedRefs`	Включить объекты с неразрешёнными ссылками
`--ClearUnresolvedRefs`	Очищать неразрешённые ссылки
`--force`	-
`--ibconnection`	`VRUNNER_IBCONNECTION`
`--db-user`	`VRUNNER_DBUSER`
`--db-pwd`	`VRUNNER_DBPWD`
`--ibcmd`	-
`--v8version`	`VRUNNER_V8VERSION`
`--uccode`	`VRUNNER_UCCODE`
`--language`	`VRUNNER_LANGUAGE`
`--locale`	`VRUNNER_LOCALE`
`--dbms-type`	`VRUNNER_DBMS_TYPE`
`--dbms-server`	`VRUNNER_DBMS_SERVER`
`--dbms-base`	`VRUNNER_DBMS_BASE`
`--dbms-user`	`VRUNNER_DBMS_USER`
`--dbms-pwd`	`VRUNNER_DBMS_PWD`
`--settings`	`VRUNNER_SETTINGS`

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner cf merge \
  --s ./vendor/BSP.cf \
  --merge-settings ./merge-settings.xml \
  --ibconnection /F./ib \
  --enable-support

compare

Сравнивает два CF-файла или CF-файл с конфигурацией базы и формирует отчёт.

bash

vrunner cf compare [опции]

Опции

Опция	По умолчанию	Описание
`--second-cf`	-	Путь ко второму CF-файлу (с чем сравниваем) (обязательный)
`--first-cf`	-	Путь к первому CF-файлу; если не задан - сравнивается конфигурация базы
`--report-dir`	`.`	Каталог для сохранения отчёта
`--report-type`	`Full`	Тип отчёта: `Full` (полный) или `Brief` (краткий)
`--report-format`	`txt`	-
`--ibconnection`	-	`VRUNNER_IBCONNECTION`
`--db-user`	-	`VRUNNER_DBUSER`
`--db-pwd`	-	`VRUNNER_DBPWD`
`--ibcmd`	-	-
`--v8version`	-	`VRUNNER_V8VERSION`
`--uccode`	-	`VRUNNER_UCCODE`
`--language`	-	`VRUNNER_LANGUAGE`
`--locale`	-	`VRUNNER_LOCALE`
`--settings`	-	`VRUNNER_SETTINGS`

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Примеры

bash

# Сравнить два CF-файла
vrunner cf compare \
  --first-cf ./old/App.cf \
  --second-cf ./new/App.cf \
  --report-dir ./reports

# Сравнить конфигурацию базы с CF-файлом
vrunner cf compare \
  --second-cf ./vendor/BSP.cf \
  --ibconnection /F./ib \
  --report-type Brief

make-dist

В разработке

Команда cf make-dist находится в разработке и пока не реализована.

Создаёт файл поставки конфигурации.

bash

vrunner cf make-dist [опции]

Опции

Опция	Переменная окружения	Описание
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

cfe - Операции с расширениями

Группа команд cfe обеспечивает работу с расширениями конфигурации 1С (.cfe): сборку из XML-исходников, разборку, загрузку в базу, выгрузку и сравнение.

bash

vrunner cfe <подкоманда> [аргументы] [опции]

compile

Собирает расширение из XML-исходников в файл .cfe.

bash

vrunner cfe compile <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому файлу расширения (`.cfe`) (обязательный)

Опции

Опция	Переменная окружения	Описание
`--s`, `--src`	`VRUNNER_SRC`	Каталог XML-исходников расширения (по умолчанию - текущий каталог)
`--extension-name`	`VRUNNER_EXTENSION_NAME`	Имя расширения (обязательный)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner cfe compile ./build/MyExtension.cfe \
  --s ./extensions/MyExtension/src \
  --extension-name MyExtension \
  --ibcmd

decompile

Разбирает файл расширения .cfe в XML-исходники.

bash

vrunner cfe decompile <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Каталог для выгрузки XML-исходников расширения (обязательный)

Опции

Опция	Переменная окружения	Описание
`--cfe-file`	`VRUNNER_CFE_FILE`	Путь к CFE-файлу для разборки (обязательный)
`--extension-name`	`VRUNNER_EXTENSION_NAME`	Имя расширения (обязательный)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner cfe decompile ./extensions/MyExtension/src \
  --cfe-file ./build/MyExtension.cfe \
  --extension-name MyExtension \
  --ibcmd

load

Загружает расширение в информационную базу из XML-исходников или CFE-файла.

bash

vrunner cfe load <SRC> [опции]

Аргументы

Аргумент	Описание
`SRC`	Каталог XML-исходников или путь к CFE-файлу

Опции

Опция	Переменная окружения	Описание
`--extension-name`	`VRUNNER_EXTENSION_NAME`	Имя расширения в базе (по умолчанию берётся из имени каталога/файла)
`--safe-mode`	-	Включить безопасный режим
`--active`	-	Активность расширения (только ibcmd)
`--unsafe-action-protection`	-	Включить защиту от опасных действий
`--used-in-rib`	-	Используется в РИБ (только ibcmd)
`--scope-infobase`	-	Область действия - ИБ (только ibcmd)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Загрузить расширение из исходников через ibcmd
vrunner cfe load ./extensions/MyExtension/src \
  --extension-name MyExtension \
  --ibcmd \
  --ibconnection /F./ib

# Загрузить с включённым безопасным режимом
vrunner cfe load ./MyExtension.cfe \
  --extension-name MyExtension \
  --safe-mode \
  --ibconnection /F./ib

unload

Выгружает расширение из информационной базы в CFE-файл.

bash

vrunner cfe unload <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому CFE-файлу (обязательный)

Опции

Опция	Переменная окружения	Описание
`--extension-name`	`VRUNNER_EXTENSION_NAME`	Имя расширения в базе (обязательный)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner cfe unload ./backup/MyExtension.cfe \
  --extension-name MyExtension \
  --ibconnection /F./ib

compare

Сравнивает два CFE-файла или CFE-файл с расширением в базе.

bash

vrunner cfe compare [опции]

Опции

Опция	По умолчанию	Переменная окружения	Описание
`--second-cfe`	-	-	Путь ко второму CFE-файлу (обязательный)
`--first-cfe`	-	-	Путь к первому CFE-файлу; если не задан - сравнивается с расширением в базе
`--extension-name`	-	-	Имя расширения
`--report-dir`	`.`	-	Каталог для отчёта
`--ibconnection`	-	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Нужна, если сравниваем с расширением в базе
`--db-user`	-	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	-	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	-	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	-	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	-	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	-	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--settings`	-	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Примеры

bash

vrunner cfe compare \
  --first-cfe ./old/MyExtension.cfe \
  --second-cfe ./new/MyExtension.cfe \
  --report-dir ./reports

epf - Операции с внешними обработками

Группа команд epf обеспечивает работу с внешними обработками и отчётами 1С (.epf, .erf): сборку из XML-исходников и разборку.

bash

vrunner epf <подкоманда> [аргументы] [опции]

compile

Собирает внешние обработки (.epf/.erf) из XML-исходников. Поддерживает обработку целого каталога с рекурсивным поиском.

bash

vrunner epf compile [SRC] [опции]

Аргументы

Аргумент	Описание
`SRC`	Каталог с XML-исходниками обработок (по умолчанию - текущий каталог)

Опции

Опция	Переменная окружения	Описание
`--R`, `--recursive`	-	Рекурсивный поиск обработок в подкаталогах
`--out`	-	Каталог для сохранения собранных обработок
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Собрать все обработки в текущем каталоге
vrunner epf compile --ibcmd

# Рекурсивно собрать все обработки в каталоге epf/
vrunner epf compile ./epf -R --out ./build/epf --ibcmd

# Через конфигуратор
vrunner epf compile ./epf \
  --ibconnection /F./ib \
  --v8version 8.3.24

Формат исходников

Каждая обработка хранится в отдельном каталоге, где корневой файл имеет расширение .os или описание в формате конфигуратора.

decompile

Разбирает файл обработки .epf/.erf (или каталог с файлами) в XML-исходники.

bash

vrunner epf decompile <SRC> [опции]

Аргументы

Аргумент	Описание
`SRC`	Путь к EPF-файлу или каталогу с EPF-файлами (обязательный)

Опции

Опция	Переменная окружения	Описание
`--R`, `--recursive`	-	Рекурсивный поиск EPF-файлов (для каталога)
`--out`	-	Каталог для сохранения разобранных исходников
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Разобрать один файл
vrunner epf decompile ./MyReport.epf --ibcmd

# Разобрать все файлы из каталога рекурсивно
vrunner epf decompile ./build/epf -R --out ./epf --ibcmd

# Через конфигуратор
vrunner epf decompile ./MyReport.epf \
  --ibconnection /F./ib \
  --out ./src/reports/MyReport

infobase - Управление информационными базами

Группа команд infobase обеспечивает создание, обновление и управление информационными базами 1С: инициализацию, обновление конфигурации БД, выгрузку и восстановление резервных копий.

bash

vrunner infobase <подкоманда> [аргументы] [опции]

init

Создаёт информационную базу и опционально загружает в неё конфигурацию из указанного источника.

bash

vrunner infobase init [опции]

Опции

Опция	Переменная окружения	Описание
`--source`	`VRUNNER_SOURCE`	Источник конфигурации: каталог исходников, `.cf` или `.dt` файл
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения. Если не указана - создаётся файловая ИБ в `build/ib`
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →

Логика работы

Если --ibconnection не указан - создаётся файловая ИБ в build/ib
Если --ibconnection /F... - создаётся файловая ИБ по указанному пути
Если указана серверная строка подключения (/S...) - ИБ должна уже существовать
Загрузка конфигурации из --source (если задан)

Примеры

bash

# Создать пустую файловую ИБ
vrunner infobase init --ibconnection /FD:/bases/MyProject

# Создать ИБ и загрузить конфигурацию из CF-файла
vrunner infobase init \
  --source ./build/MyApp.cf \
  --ibconnection /F./tmp-ib \
  --ibcmd

# Создать ИБ и загрузить из исходников
vrunner infobase init \
  --source ./src \
  --ibconnection /F./tmp-ib

# Загрузить конфигурацию в существующую серверную ИБ через ibcmd
vrunner infobase init \
  --source ./build/MyApp.cf \
  --ibconnection "/SMyServer\MyIB" \
  --ibcmd \
  --dbms-type PostgreSQL \
  --dbms-server localhost \
  --dbms-base my_db \
  --dbms-user postgres \
  --dbms-pwd secret

update

Обновляет конфигурацию БД информационной базы. Опционально загружает конфигурацию из нового источника перед обновлением.

bash

vrunner infobase update [опции]

Опции

Опция	По умолчанию	Описание
`--source`	-	Источник конфигурации: каталог исходников или `.cf` файл
`--target`	-	Цель обновления: `main` - основная конфигурация; имя расширения - конкретное расширение; пусто - всё
`--rtype`	`v1`	Режим реструктуризации: `v1` (обычный), `v2` (оптимизированный)
`--increment`	-	Инкрементальная загрузка по индексу изменений
`--dynamic`	-	Разрешить динамическое обновление конфигурации
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

# Обновить конфигурацию БД (загрузить исходники уже в базе)
vrunner infobase update --ibconnection /F./ib

# Загрузить новую конфигурацию и обновить БД
vrunner infobase update \
  --source ./build/MyApp.cf \
  --ibconnection /F./ib \
  --rtype v2

# Обновить с динамическим обновлением
vrunner infobase update \
  --ibconnection /F./ib \
  --dynamic

dump-dt

Выгружает информационную базу в файл резервной копии (.dt).

bash

vrunner infobase dump-dt <OUT> [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому DT-файлу (обязательный)

Опции

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner infobase dump-dt ./backup/MyProject_2026-04.dt \
  --ibconnection /F./ib \
  --v8version 8.3.24

restore-dt

Восстанавливает информационную базу из файла резервной копии (.dt).

bash

vrunner infobase restore-dt <SRC> [опции]

Аргументы

Аргумент	Описание
`SRC`	Путь к DT-файлу для восстановления (обязательный)

Опции

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash

vrunner infobase restore-dt ./backup/MyProject_2026-04.dt \
  --ibconnection /F./ib

repo - Работа с хранилищем конфигурации

Группа команд repo обеспечивает работу с хранилищем конфигурации 1С: подключение, загрузку изменений, управление пользователями, фиксацию изменений, блокировку и разблокировку.

bash

vrunner repo <подкоманда> [аргументы] [опции]

Подключение и платформа

Большинство подкоманд repo работают с информационной базой и хранилищем. Строка подключения и опции СУБД описаны на странице Подключение к базе данных.

create

Создаёт новое хранилище конфигурации 1С.

bash

vrunner repo create [опции]

Примеры

bash

vrunner repo create \
  --storage-name D:/repos/MyProject \
  --storage-user Администратор \
  --storage-pwd secret \
  --ibconnection /F./ib

bind

Подключает информационную базу к хранилищу конфигурации.

bash

vrunner repo bind [опции]

Опции

Опция	Описание
`--ignore-already-bound`	Не считать ошибкой, если ИБ уже подключена к хранилищу
`--do-not-replace-cfg`	-
`--ibconnection`	`VRUNNER_IBCONNECTION`
`--db-user`	`VRUNNER_DBUSER`
`--db-pwd`	`VRUNNER_DBPWD`
`--ibcmd`	-
`--v8version`	`VRUNNER_V8VERSION`
`--uccode`	`VRUNNER_UCCODE`
`--language`	`VRUNNER_LANGUAGE`
`--locale`	`VRUNNER_LOCALE`
`--storage-name`	`VRUNNER_STORAGE_NAME`
`--storage-user`	`VRUNNER_STORAGE_USER`
`--storage-pwd`	`VRUNNER_STORAGE_PWD`
`--storage-ver`	`VRUNNER_STORAGE_VER`
`--settings`	`VRUNNER_SETTINGS`

Подключение к базе данных →

Примеры

bash

vrunner repo bind \
  --storage-name D:/repos/MyProject \
  --storage-user DevUser \
  --storage-pwd secret \
  --ibconnection /F./ib \
  --ignore-already-bound

unbind

Отключает информационную базу от хранилища конфигурации.

bash

vrunner repo unbind [опции]

Примеры

bash

vrunner repo unbind \
  --ibconnection /F./ib \
  --storage-user DevUser \
  --storage-pwd secret

load

Обновляет конфигурацию информационной базы из хранилища (загружает последнюю версию).

bash

vrunner repo load [опции]

Примеры

bash

vrunner repo load \
  --ibconnection /F./ib \
  --storage-name D:/repos/MyProject \
  --storage-user DevUser \
  --storage-pwd secret \
  --storage-ver 42

commit

Помещает изменения в хранилище конфигурации (фиксирует захваченные объекты).

bash

vrunner repo commit [опции]

Опции

Опция	Описание
`--objects`	Путь к XML-файлу со списком объектов для помещения
`--comment`	Комментарий к фиксируемым объектам
`--keep-locked`	Оставить объекты захваченными после помещения
`--force`	-
`--ibconnection`	`VRUNNER_IBCONNECTION`
`--db-user`	`VRUNNER_DBUSER`
`--db-pwd`	`VRUNNER_DBPWD`
`--ibcmd`	-
`--v8version`	`VRUNNER_V8VERSION`
`--uccode`	`VRUNNER_UCCODE`
`--language`	`VRUNNER_LANGUAGE`
`--locale`	`VRUNNER_LOCALE`
`--dbms-type`	`VRUNNER_DBMS_TYPE`
`--dbms-server`	`VRUNNER_DBMS_SERVER`
`--dbms-base`	`VRUNNER_DBMS_BASE`
`--dbms-user`	`VRUNNER_DBMS_USER`
`--dbms-pwd`	`VRUNNER_DBMS_PWD`
`--storage-name`	`VRUNNER_STORAGE_NAME`
`--storage-user`	`VRUNNER_STORAGE_USER`
`--storage-pwd`	`VRUNNER_STORAGE_PWD`
`--storage-ver`	`VRUNNER_STORAGE_VER`
`--settings`	`VRUNNER_SETTINGS`

Подключение к базе данных →

Примеры

bash

vrunner repo commit \
  --ibconnection /F./ib \
  --storage-name D:/repos/MyProject \
  --storage-user DevUser \
  --storage-pwd secret \
  --comment "Задача #123: добавлены новые справочники"

save-cf

Сохраняет конфигурацию из хранилища в CF-файл.

bash

vrunner repo save-cf [OUT] [опции]

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому CF-файлу

Примеры

bash

vrunner repo save-cf ./build/MyApp.cf \
  --storage-name D:/repos/MyProject \
  --storage-user DevUser \
  --storage-pwd secret \
  --storage-ver 100

create-user

Создаёт пользователя в хранилище конфигурации.

bash

vrunner repo create-user [опции]

copy-user

Копирует права пользователя хранилища от одного пользователя к другому.

bash

vrunner repo copy-user [опции]

lock

Устанавливает блокировку объектов хранилища для захвата.

bash

vrunner repo lock [опции]

unlock

Снимает захват объектов хранилища.

bash

vrunner repo unlock [опции]

cluster - Управление кластером серверов

Группа команд cluster обеспечивает управление кластером серверов 1С через утилиты rac/ras: получение информации, создание и удаление кластера, управление сеансами и фоновыми заданиями.

bash

vrunner cluster <подкоманда> [опции]

Подключение и администрирование

Все подкоманды cluster управляют кластером через утилиту rac/ras. Подробнее о строке подключения: Подключение к базе данных.

Опции, доступные всем подкомандам:

Опция	Переменная окружения	Описание
`--ras`	`VRUNNER_RAS`	Сетевой адрес RAS (по умолчанию `localhost:1545`)
`--rac`	`VRUNNER_RAC`	Путь к утилите `rac`
`--db-name`	`VRUNNER_IBNAME`	Имя информационной базы в кластере
`--cluster`	-	Идентификатор кластера
`--cluster-name`	-	Имя кластера
`--cluster-admin`	`VRUNNER_CLUSTERADMIN_USER`	Имя администратора кластера
`--cluster-pwd`	`VRUNNER_CLUSTERADMIN_PWD`	Пароль администратора кластера
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (для идентификации базы в кластере)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

TIP

cluster create дополнительно использует опции СУБД (--dbms-type, --dbms-server, --dbms-base, --dbms-user, --dbms-pwd).

info

Выводит информацию об информационной базе в кластере.

bash

vrunner cluster info [опции]

Примеры

bash

vrunner cluster info \
  --ras localhost:1545 \
  --db-name MyInfobase \
  --cluster-admin ClusterAdmin \
  --cluster-pwd secret

create

Создаёт новый кластер серверов 1С.

bash

vrunner cluster create [опции]

remove

Удаляет кластер серверов 1С.

bash

vrunner cluster remove [опции]

session

Группа подкоманд для управления сеансами информационной базы.

bash

vrunner cluster session <подкоманда> [опции]

session lock

Блокирует новые сеансы для информационной базы.

bash

vrunner cluster session lock [опции]

Опции

Опция	Переменная окружения	Описание
`--permission-code`	-	Код допуска к заблокированной ИБ
`--denied-message`	-	Сообщение, отображаемое при попытке начать сеанс
`--ras`	`VRUNNER_RAS`	Сетевой адрес RAS (по умолчанию `localhost:1545`)
`--rac`	`VRUNNER_RAC`	Путь к утилите `rac`
`--db-name`	`VRUNNER_IBNAME`	Имя ИБ в кластере
`--cluster`	-	Идентификатор кластера
`--cluster-name`	-	Имя кластера
`--cluster-admin`	`VRUNNER_CLUSTERADMIN_USER`	Имя администратора кластера
`--cluster-pwd`	`VRUNNER_CLUSTERADMIN_PWD`	Пароль администратора кластера
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Примеры

bash

vrunner cluster session lock \
  --ras localhost:1545 \
  --db-name MyInfobase \
  --cluster-admin ClusterAdmin \
  --cluster-pwd secret \
  --permission-code MySecretCode \
  --denied-message "База закрыта на обслуживание. Используйте код: MySecretCode"

session unlock

Снимает блокировку новых сеансов для информационной базы.

bash

vrunner cluster session unlock [опции]

Примеры

bash

vrunner cluster session unlock \
  --ras localhost:1545 \
  --db-name MyInfobase \
  --cluster-admin ClusterAdmin \
  --cluster-pwd secret

session kill

Принудительно завершает активные сеансы информационной базы.

bash

vrunner cluster session kill [опции]

Примеры

bash

vrunner cluster session kill \
  --ras localhost:1545 \
  --db-name MyInfobase \
  --cluster-admin ClusterAdmin \
  --cluster-pwd secret

jobs

Группа подкоманд для управления фоновыми заданиями информационной базы.

bash

vrunner cluster jobs <подкоманда> [опции]

jobs lock

Блокирует выполнение фоновых заданий для информационной базы.

bash

vrunner cluster jobs lock [опции]

jobs unlock

Снимает блокировку фоновых заданий для информационной базы.

bash

vrunner cluster jobs unlock [опции]

Типичный сценарий: обновление под нагрузкой

bash

# 1. Заблокировать новые сеансы
vrunner cluster session lock \
  --ras localhost \
  --db-name MyIB \
  --cluster-admin admin \
  --cluster-pwd pwd \
  --permission-code UPDATE2026

# 2. Завершить активные сеансы
vrunner cluster session kill \
  --ras localhost \
  --db-name MyIB \
  --cluster-admin admin \
  --cluster-pwd pwd

# 3. Заблокировать фоновые задания
vrunner cluster jobs lock \
  --ras localhost \
  --db-name MyIB \
  --cluster-admin admin \
  --cluster-pwd pwd

# 4. ... обновление ИБ ...

# 5. Разблокировать задания и сеансы
vrunner cluster jobs unlock ...
vrunner cluster session unlock ...

run - Запуск 1С

Группа команд run обеспечивает запуск 1С:Предприятия и Конфигуратора с нужными параметрами из командной строки.

bash

vrunner run <подкоманда> [опции]

enterprise

Запускает 1С:Предприятие в указанном режиме.

bash

vrunner run enterprise [опции]

Опции

Опция	Переменная окружения	Описание
`--command`	`VRUNNER_COMMAND`	Строка, передаваемая в параметр `/C`
`--execute`	`VRUNNER_EXECUTE`	Путь к внешней обработке 1С для запуска (поддерживается переменная `$runnerRoot`)
`--url`	-	Навигационная ссылка для перехода после старта
`--no-wait`	-	Не ожидать завершения запущенного процесса
`--exitCodePath`	-	Путь к файлу статуса выполнения (0=успех, 1=ошибка, 2=предупреждение)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--nocacheuse`	`VRUNNER_NOCACHEUSE`	Не использовать кеш платформы
`--ordinaryapp`	`VRUNNER_ORDINARYAPP`	Режим запуска: `1` (толстый), `0` (тонкий), `-1` (авто)
`--additional`	`VRUNNER_ADDITIONAL`	Дополнительные параметры запуска платформы
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Примеры

bash

# Запустить обработку для первоначального заполнения ИБ
vrunner run enterprise \
  --ibconnection /F./ib \
  --execute ./tools/InitIB.epf \
  --exitCodePath ./build/result.txt

# Запустить с командой и дождаться завершения
vrunner run enterprise \
  --ibconnection /F./ib \
  --command "StartFilling" \
  --v8version 8.3.24

# Запустить в фоне (не ждать завершения)
vrunner run enterprise \
  --ibconnection /F./ib \
  --execute ./tools/Server.epf \
  --no-wait

# Запустить с навигационной ссылкой
vrunner run enterprise \
  --ibconnection /F./ib \
  --url "e1cib/list/Catalog.Контрагенты"

Переменная $runnerRoot

В опции --execute поддерживается переменная $runnerRoot, которая раскрывается в корневой каталог vanessa-runner. Это позволяет использовать встроенные обработки инструмента.

designer

Запускает Конфигуратор 1С.

bash

vrunner run designer [опции]

Опции

Опция	Переменная окружения	Описание
`--additional`	`VRUNNER_ADDITIONAL`	Дополнительные параметры запуска конфигуратора
`--no-wait`	-	Не ожидать завершения
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--storage-name`	`VRUNNER_STORAGE_NAME`	Адрес хранилища конфигурации
`--storage-user`	`VRUNNER_STORAGE_USER`	Пользователь хранилища
`--storage-pwd`	`VRUNNER_STORAGE_PWD`	Пароль хранилища
`--storage-ver`	`VRUNNER_STORAGE_VER`	Версия хранилища
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Примеры

bash

# Запустить конфигуратор с дополнительными ключами
vrunner run designer \
  --ibconnection /F./ib \
  --additional "/DumpConfigToFiles ./src"

# Запустить и не ждать завершения
vrunner run designer \
  --ibconnection /F./ib \
  --no-wait

test - Запуск тестов

Группа команд test обеспечивает запуск автоматизированного тестирования 1С-конфигураций через фреймворк Vanessa-ADD: как модульного (xUnit), так и функционального (BDD).

bash

vrunner test <подкоманда> [аргументы] [опции]

xunit

Запускает модульные тесты через обработку xddTestRunner.epf (xUnit for 1C).

bash

vrunner test xunit [TESTSPATH] [опции]

Аргументы

Аргумент	Переменная окружения	Описание
`TESTSPATH`	`VRUNNER_TESTSPATH`	Путь к каталогу или файлу с тестами, или к встроенным тестам (с `--config-tests`)

Опции

Опция	Переменная окружения	Описание
`--workspace`	`VRUNNER_WORKSPACE`	Путь к папке проекта для макросов `$workspace` (по умолчанию - текущий)
`--pathxunit`	`VRUNNER_PATHXUNIT`	Путь к внешней обработке `xddTestRunner.epf` (по умолчанию из vanessa-add)
`--reportsxunit`	`VRUNNER_REPORTSXUNIT`	Параметры формирования отчётов: `ФорматВывода{Путь};ФорматВывода{Путь}`
`--reportxunit`	-	Путь к каталогу с отчётом jUnit (устарел, используйте `--reportsxunit`)
`--xddExitCodePath`	-	Путь к файлу статуса (0=пройдены, 1=не пройдены)
`--xddConfig`	-	Путь к конфигурационному файлу xUnitFor1c
`--testclient`	-	Параметры тест-клиента: `Пользователь:Пароль:Порт`
`--testclient-additional`	-	Дополнительные параметры запуска тест-клиента
`--config-tests`	`VRUNNER_CONFIG_TESTS`	Загружать тесты, встроенные в конфигурацию
`--no-wait`	-	Не ожидать завершения
`--xdddebug`	-	Выводить отладочные сообщения при прогоне
`--no-shutdown`	-	Не завершать 1С после выполнения тестов
`--clear-reports`	-	Очищать каталоги отчётов перед запуском
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--nocacheuse`	`VRUNNER_NOCACHEUSE`	Не использовать кеш платформы
`--ordinaryapp`	`VRUNNER_ORDINARYAPP`	Режим запуска: `1` (толстый), `0` (тонкий), `-1` (авто)
`--additional`	`VRUNNER_ADDITIONAL`	Дополнительные параметры запуска платформы
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Формат reportsxunit

Параметр --reportsxunit задаёт список форматов отчётов через точку с запятой:

jUnit{./build/reports/junit.xml};HTML{./build/reports/tests.html}

Поддерживаемые форматы: jUnit, HTML, allure, GenericExecution.

Примеры

bash

# Запустить тесты и сформировать JUnit-отчёт
vrunner test xunit ./tests \
  --ibconnection /F./ib \
  --reportsxunit "jUnit{./build/reports/junit.xml}"

# Тесты, встроенные в конфигурацию
vrunner test xunit \
  --ibconnection /F./ib \
  --config-tests \
  --reportsxunit "jUnit{./build/reports/junit.xml}"

# Запустить конкретный файл с тестами
vrunner test xunit ./tests/MyTests.os \
  --ibconnection /F./ib \
  --xddExitCodePath ./build/status.txt

# С тест-клиентом (клиент-серверный режим)
vrunner test xunit ./tests \
  --ibconnection "/SMyServer\MyIB" \
  --testclient "Тест:password:1538" \
  --reportsxunit "jUnit{./build/reports/junit.xml}"

vanessa

Запускает функциональные тесты по сценариям в формате Gherkin через обработку bddRunner.epf (Vanessa-ADD BDD).

bash

vrunner test vanessa [опции]

Опции

Опция	Переменная окружения	Описание
`--feature-path`	`VRUNNER_FEATUREPATH`	Путь к каталогу с фичами или к конкретному файлу `.feature`
`--bddrunner-path`	`VRUNNER_PATHVANESSA`	Путь к `bddRunner.epf` (по умолчанию из vanessa-add)
`--vanessasettings`	`VRUNNER_VANESSASETTINGS`	Путь к файлу настроек фреймворка тестирования
`--workspace`	`VRUNNER_WORKSPACE`	Путь к папке проекта
`--tags-ignore`	-	Теги для игнорирования файлов фич
`--tags-filter`	-	Теги для фильтрации файлов фич
`--additional-keys`	-	Дополнительные параметры, передаваемые в `/C`
`--no-wait`	-	Не ожидать завершения
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--nocacheuse`	`VRUNNER_NOCACHEUSE`	Не использовать кеш платформы
`--ordinaryapp`	`VRUNNER_ORDINARYAPP`	Режим запуска: `1` (толстый), `0` (тонкий), `-1` (авто)
`--additional`	`VRUNNER_ADDITIONAL`	Дополнительные параметры запуска платформы
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о форматах строки подключения и ibcmd: Подключение к базе данных →

Примеры

bash

# Запустить все фичи
vrunner test vanessa \
  --ibconnection /F./ib \
  --feature-path ./features \
  --vanessasettings ./vb-params.json

# Запустить с фильтром по тегам
vrunner test vanessa \
  --ibconnection /F./ib \
  --feature-path ./features \
  --tags-filter "@smoke" \
  --tags-ignore "@wip"

# Запустить конкретную фичу
vrunner test vanessa \
  --ibconnection /F./ib \
  --feature-path ./features/Catalog.feature

vanessasettings

Файл настроек vb-params.json содержит конфигурацию Vanessa-ADD: пути к отчётам, настройки скриншотов, тайм-ауты и другие параметры. Документацию по формату файла см. в репозитории vanessa-add.

validate - Проверка конфигурации

Группа команд validate обеспечивает статическую проверку конфигурации 1С: синтаксическую проверку через конфигуратор и проверку в EDT.

bash

vrunner validate <подкоманда> [опции]

syntax-check

Выполняет проверку синтаксиса конфигурации в указанных режимах через конфигуратор. Формирует отчёт в формате JUnit XML, совместимый с системами CI/CD.

bash

vrunner validate syntax-check [опции]

Опции

Опция	По умолчанию	Переменная окружения	Описание
`--mode`	-	-	Режимы проверки (можно указать несколько через повторение опции)
`--junitpath`	-	`VRUNNER_JUNITPATH`	Путь к файлу отчёта JUnit XML
`--exception-file`	-	-	Путь к файлу исключений (UTF-8, по одному исключению на строку)
`--groupbymetadata`	`false`	-	Группировать ошибки по объектам метаданных
`--testsuitename`	`syntax-check`	-	Имя тестового набора в JUnit-отчёте
`--ibconnection`	-	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	-	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	-	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	-	Использовать `ibcmd` вместо Конфигуратора
`--v8version`	-	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	-	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	-	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	-	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	-	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	-	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	-	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	-	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	-	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--storage-name`	-	`VRUNNER_STORAGE_NAME`	Адрес хранилища
`--storage-user`	-	`VRUNNER_STORAGE_USER`	Пользователь хранилища
`--storage-pwd`	-	`VRUNNER_STORAGE_PWD`	Пароль хранилища
`--storage-ver`	-	`VRUNNER_STORAGE_VER`	Версия хранилища
`--settings`	-	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →

Доступные режимы проверки (--mode)

Режим	Описание
`ThinClient`	Тонкий клиент
`WebClient`	Веб-клиент
`Server`	Сервер
`ExternalConnection`	Внешнее соединение
`ExternalConnectionServer`	Внешнее соединение (клиент-серверный)
`MobileClient`	Мобильный клиент
`MobileClientStandalone`	Мобильный клиент (автономный)
`MobileAppClient`	Мобильное приложение (клиент)
`MobileAppServer`	Мобильное приложение (сервер)
`ThickClientManagedApplication`	Толстый клиент (управляемое приложение)
`ThickClientServerManagedApplication`	Толстый клиент (управляемое, клиент-серверный)
`ThickClientOrdinaryApplication`	Толстый клиент (обычное приложение)
`ThickClientServerOrdinaryApplication`	Толстый клиент (обычное, клиент-серверный)
`ConfigLogIntegrity`	Проверка логической целостности конфигурации
`IncorrectReferences`	Поиск некорректных ссылок
`DistributiveModules`	Поставка модулей без исходных текстов
`UnreferenceProcedures`	Поиск неиспользуемых процедур и функций
`HandlersExistence`	Проверка существования назначенных обработчиков
`EmptyHandlers`	Поиск пустых обработчиков
`ExtendedModulesCheck`	Расширенная проверка модулей
`CheckUseModality`	Поиск использования модальности
`CheckUseSynchronousCalls`	Поиск синхронных вызовов
`UnsupportedFunctional`	Поиск неподдерживаемой функциональности
`AllExtensions`	Проверка всех расширений

Примеры

bash

# Проверить синтаксис для нескольких режимов клиента
vrunner validate syntax-check \
  --ibconnection /F./ib \
  --mode ThinClient \
  --mode Server \
  --mode WebClient \
  --junitpath ./build/reports/syntax.xml

# Проверить с группировкой по метаданным и файлом исключений
vrunner validate syntax-check \
  --ibconnection /F./ib \
  --mode ThinClient \
  --mode Server \
  --junitpath ./build/reports/syntax.xml \
  --groupbymetadata \
  --exception-file ./syntax-check-exceptions.txt \
  --testsuitename "MyProject syntax check"

Файл исключений

Файл исключений (--exception-file) позволяет игнорировать известные/допустимые ошибки. Каждая строка файла - одна строка из сообщения об ошибке, которую нужно пропустить. Кодировка: UTF-8.

Интеграция с CI

JUnit-отчёт совместим с GitLab CI, Jenkins, GitHub Actions и другими системами CI/CD. Укажите путь к файлу в настройках сборки для публикации результатов проверки.

edt

В разработке

Команда validate edt находится в разработке и пока не реализована.

Выполняет проверку проекта средствами Enterprise Development Tools (EDT).

bash

vrunner validate edt [опции]

Файл настроек (autumn-properties.json)

vanessa-runner использует файл autumn-properties.json для задания настроек по умолчанию на уровне проекта.

Расположение файла

Файл autumn-properties.json должен находиться в рабочем каталоге, из которого запускается vrunner. Как правило, это корень проекта.

Формат файла

json

{
  "runner": {
    "<опция>": "<значение>",
    "<команда>": {
      "<опция>": "<значение>"
    }
  }
}

Ключи задаются через пространство имён runner.

Каскад приоритетов

Настройки применяются в следующем порядке (от низшего приоритета к высшему):

Значения по умолчанию из пакета vanessa-runner
autumn-properties.json в текущем рабочем каталоге
Переменные окружения
Аргументы командной строки

Примеры конфигурации

Базовые настройки подключения

json

{
  "runner": {
    "ibconnection": "/FD:/bases/MyProject",
    "db-user": "Администратор",
    "db-pwd": "",
    "v8version": "8.3.24"
  }
}

Настройки для конкретных команд

json

{
  "runner": {
    "ibconnection": "/F./ib",
    "v8version": "8.3.24",
    "cf": {
      "compile": {
        "src": "./src"
      }
    },
    "repo": {
      "load": {
        "storage-name": "D:/repos/MyProject",
        "storage-user": "StorageUser"
      }
    }
  }
}

Пример для CI-окружения

json

{
  "runner": {
    "v8version": "8.3.24",
    "ibcmd": true,
    "test": {
      "xunit": {
        "reportsxunit": "jUnit{./build/reports/junit.xml}"
      }
    }
  }
}

Уровни логирования

Уровень логирования настраивается через autumn-properties.json:

json

{
  "logos": {
    "logger": {
      "vrunner": "DEBUG"
    }
  }
}

Доступные уровни: DEBUG, INFO, WARN, ERROR.

Или через переменную окружения:

bash

export LOGOS_LOGGER_VRUNNER=DEBUG
vrunner cf compile ./build/App.cf

Переменные окружения

Все опции vanessa-runner можно задавать через переменные окружения. Это удобно в CI/CD-пайплайнах, где параметры подключения нежелательно передавать в командной строке.

Приоритет

Параметры применяются в следующем порядке (каждый следующий перекрывает предыдущий):

Значение по умолчанию
Файл настроек (autumn-properties.json)
Переменная окружения
Аргумент командной строки

Полный список переменных

Подключение к ИБ

Переменная	Опция	Описание
`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`	Язык сеанса (локаль)

СУБД (при работе через ibcmd с серверной ИБ)

Переменная	Опция	Описание
`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`	Версия хранилища

Кластер 1С

Переменная	Опция	Описание
`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_NOCACHEUSE`	`--nocacheuse`	Не использовать кеш платформы
`VRUNNER_ORDINARYAPP`	`--ordinaryapp`	Режим запуска: `1` (толстый), `0` (тонкий), `-1` (авто)
`VRUNNER_ADDITIONAL`	`--additional`	Дополнительные параметры запуска платформы

Прочее

Переменная	Опция	Описание
`VRUNNER_SETTINGS`	`--settings`	Путь к файлу настроек (JSON)

Пример для CI/CD

bash

export VRUNNER_IBCONNECTION="/S1c-server\MyBase"
export VRUNNER_DBUSER=Admin
export VRUNNER_DBPWD=$SECRET_IB_PWD
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
vrunner test xunit ./tests

Установка

Требования

OneScript версии 2.0 и выше
Платформа 1С:Предприятие 8.3 (для работы с базами)

Установка через opm

bash

opm install vanessa-runner

После установки команда vrunner будет доступна глобально.

Установка из исходников

bash

git clone https://github.com/vanessa-opensource/vanessa-runner.git
cd vanessa-runner
opm install -l

Проверка установки

bash

vrunner --version

Ожидаемый вывод:

vanessa-runner 3.x.x

Обновление

bash

opm install -u vanessa-runner

Установка зависимостей для разработки

bash

opm install

Зависимости устанавливаются в папку oscript_modules/.

Первые шаги

Синтаксис команд

Все команды vanessa-runner имеют единую структуру:

bash

vrunner <группа> <подкоманда> [аргументы] [опции]

Например:

bash

# Собрать конфигурацию из исходников
vrunner cf compile ./build/MyApp.cf --s ./src

# Разобрать конфигурацию в исходники
vrunner cf decompile --cf-file MyApp.cf ./src

# Инициализировать ИБ из CF-файла
vrunner infobase init --source ./build/MyApp.cf --ibconnection /FMyInfobase

# Запустить xUnit-тесты
vrunner test xunit ./tests --ibconnection /FMyInfobase

Общие опции

Все команды поддерживают следующие общие опции:

Подключение к ИБ

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения (`/F<путь>` или `/S<сервер>\<имяИБ>`)
`--db-user`	`VRUNNER_DBUSER`	Пользователь ИБ
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту ibcmd вместо конфигуратора

Платформа

Опция	Переменная окружения	Описание
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С (например, `8.3.24`)
`--uccode`	`VRUNNER_UCCODE`	Код разрешения (ключ блокировки)
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)

Настройки по умолчанию

Создайте файл autumn-properties.json в каталоге проекта для задания настроек по умолчанию:

json

{
  "runner": {
    "ibconnection": "/FD:/bases/MyProject",
    "v8version": "8.3.24",
    "db-user": "Администратор"
  }
}

Настройки применяются с таким приоритетом (от низшего к высшему):

Значения по умолчанию из пакета vanessa-runner
autumn-properties.json в текущем каталоге
Переменные окружения
Аргументы командной строки

Типичный workflow CI/CD

Пример типичного рабочего процесса в CI:

bash

# 1. Инициализация ИБ
vrunner infobase init \
  --source ./build/MyApp.cf \
  --ibconnection /F./tmp-ib

# 2. Обновление конфигурации (при необходимости)
vrunner infobase update \
  --ibconnection /F./tmp-ib

# 3. Запуск тестов
vrunner test xunit ./tests \
  --ibconnection /F./tmp-ib \
  --reportsxunit "jUnit{./build/reports/junit.xml}"

Вывод помощи

Для любой команды доступна встроенная справка:

bash

vrunner --help
vrunner cf --help
vrunner cf compile --help

Миграция с 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 с ключами вида --ключ:

json

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

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

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.

О проекте ​

Что это такое? ​

Архитектура ​

Группы команд ​

Поддержка ​

Подключение к базе данных ​

Строка подключения (--ibconnection) ​

Учётные данные ИБ ​

Конфигуратор или ibcmd? ​

Когда нужны опции СУБД (--dbms-*) ​

Когда база необязательна (временная ИБ) ​

Примеры ​

Файловая ИБ ​

Серверная ИБ через Конфигуратор ​

Серверная ИБ через ibcmd ​

Без базы (временная ИБ) ​

Загрузка в существующую серверную ИБ через ibcmd ​

cf - Операции с конфигурацией ​

compile ​

Аргументы ​

Опции ​

Примеры ​

decompile ​

Аргументы ​

Опции ​

Примеры ​

load ​

Аргументы ​

Опции ​

Примеры ​

unload ​

Аргументы ​

Опции ​

Примеры ​

merge ​

Опции ​

Примеры ​

compare ​

Опции ​

Примеры ​

make-dist ​

Опции ​

cfe - Операции с расширениями ​

compile ​

Аргументы ​

Опции ​

Примеры ​

decompile ​

Аргументы ​

Опции ​

Примеры ​

load ​

Аргументы ​

Опции ​

Примеры ​

unload ​

Аргументы ​

Опции ​

Примеры ​

compare ​

Опции ​

Примеры ​

epf - Операции с внешними обработками ​

compile ​

Аргументы ​

Опции ​

Примеры ​

decompile ​

Аргументы ​

Опции ​

Примеры ​

infobase - Управление информационными базами ​

init ​

Опции ​

Логика работы ​

Примеры ​

update ​

Опции ​

Примеры ​

dump-dt ​

О проекте

Что это такое?

Архитектура

Группы команд

Поддержка

Подключение к базе данных

Строка подключения (--ibconnection)

Учётные данные ИБ

Конфигуратор или ibcmd?

Когда нужны опции СУБД (--dbms-*)

Когда база необязательна (временная ИБ)

Примеры

Файловая ИБ

Серверная ИБ через Конфигуратор

Серверная ИБ через ibcmd

Без базы (временная ИБ)

Загрузка в существующую серверную ИБ через ibcmd

cf - Операции с конфигурацией

compile

Аргументы

Опции

Примеры

decompile

Аргументы

Опции

Примеры

load

Аргументы

Опции

Примеры

unload

Аргументы

Опции

Примеры

merge

Опции

Примеры

compare

Опции

Примеры

make-dist

Опции

cfe - Операции с расширениями

compile

Аргументы

Опции

Примеры

decompile

Аргументы

Опции

Примеры

load

Аргументы

Опции

Примеры

unload

Аргументы

Опции

Примеры

compare

Опции

Примеры

epf - Операции с внешними обработками

compile

Аргументы

Опции

Примеры

decompile

Аргументы

Опции

Примеры

infobase - Управление информационными базами

init

Опции

Логика работы

Примеры

update

Опции

Примеры

dump-dt