Профили запуска
Профиль запуска — это файл настроек vanessa-runner в корне проекта, который читается раннером автоматически и определяет, над какой базой и с какими параметрами выполняются команды расширения (создание ИБ, загрузка конфигурации, запуск, тесты, публикация сервера, отладка). Так одни и те же команды работают над разными базами — локальной, dev, демонстрационной — без правки самих команд.
Формат зависит от версии vanessa-runner
Расширение само определяет установленную версию vanessa-runner и выбирает формат файла настроек:
| Версия vrunner | Базовый профиль | Именованный профиль |
|---|---|---|
| 2.x | env.json | env.<id>.json (env.dev.json → профиль dev) |
| 3.x | autumn-properties.json | autumn-properties.<id>.json |
vanessa-runner 3 — это отдельный инструмент со своим форматом настроек (каскад vrunner.<команда>.<опция>), поэтому расширение не конвертирует env.json на лету. Профили обнаруживаются автоматически по именам файлов в корне проекта: базовый идёт первым, остальные — по алфавиту.
Перенос существующих настроек 2.x в формат 3.0 выполняется официальным инструментом из состава vanessa-runner.
У строки подключения к ИБ рядом с полем есть «Выбрать базу…» — список информационных баз платформы, тот же, что 1С показывает при запуске. Выбор подставляет строку в поле, поэтому вписать своё по-прежнему можно. Список читается из файла платформы (ibases.v8i), включая общие списки организации. Запустить базу из этого списка, не заходя в профиль, можно в панели 1С: Администрирование.
Панель «Профиль запуска»
Под панелью «Команды» находится плашка Профиль запуска — что именно видят команды vrunner:
- Профиль — активный профиль (клик открывает выбор).
- vanessa-runner:
<версия>— определённая версия и синтаксис (2.x/3.x); клик — определить версию заново (после переустановки раннера). - Файл настроек — базовый файл схемы. Если файла нет, он не читается или записан в формате другой версии vanessa-runner, пункт подсвечен предупреждением, команды заблокированы, а подсказка говорит почему; клик создаёт файл или открывает его.
- ИБ — строка подключения из файла настроек.
- Временные параметры — разовые переопределения (см. ниже).
Статус-бар и выбор профиля
В статусной строке слева — элемент $(rocket) <профиль>. Если базового файла настроек нет, элемент подсвечен предупреждением (команды заблокированы). Клик открывает меню Профиль запуска 1С:
- Список профилей — выбор активного (отмечен
$(check)). - Создать профиль… — спрашивает идентификатор, создаёт
env.<id>.json/autumn-properties.<id>.jsonи делает его активным. - Открыть редактор профиля — форма-редактор файла настроек.
- Временные параметры / Сбросить параметры — см. ниже.
- Определить версию — перечитать версию vanessa-runner.
Как раннер читает файл настроек из корня проекта сам, базовый профиль не требует --settings — расширение добавляет --settings <файл> только для именованного профиля. Активный профиль у каждого проекта свой, хранится локально (workspaceState) и не коммитится.
Временные параметры
Поверх активного профиля можно задать разовые переопределения отдельными флагами — они применяются ко всем командам vrunner, не меняя файл профиля:
| Параметр | Флаг vrunner |
|---|---|
| Строка подключения к ИБ | --ibconnection (файловая /F<путь>, серверная /S<сервер>\<имя_ИБ>) |
| Пользователь ИБ | --db-user |
| Пароль ИБ | --db-pwd |
| Версия платформы | --v8version |
| Дополнительные параметры | --additional |
vanessa-runner 3 разбирает строку подключения по пробелам: путь с пробелом расширение закавычивает само (/F"C:\каталог с пробелом\ib"), обе версии такую запись принимают. Значение, начинающееся с дефиса, разбор 3.x не принимает через пробел — пишите --опция=значение.
Заданы только непустые поля — остальное берётся из файла профиля. Когда переопределения активны (временные параметры или env.local.json), в статус-баре рядом с профилем появляется *. Временные параметры, как и выбор профиля, хранятся локально и не коммитятся.
ИБ на каждую ветку: ${gitBranch}
В значениях профиля работает переменная ${gitBranch} — имя текущей ветки git, приведённое к безопасному имени каталога (feature/RS-123 → feature-RS-123). Так у каждой ветки появляется своя информационная база:
"--ibconnection": "/F./build/${gitBranch}"Значение вычисляется в момент запуска команды — переключение ветки подхватывается сразу, без перезагрузки окна. Переменная поддерживается в опциях временных параметров (--ibconnection, --db-user, --db-pwd, --v8version, --additional) и работает также в самих временных параметрах и в env.local.json.
Вне репозитория git подстановки не будет: значение уйдёт в команду как есть, с литеральным ${gitBranch} в пути. Расширение однократно предупредит об этом.
Локальные перекрытия: env.local.json
Файл env.local.json в корне проекта перекрывает активный профиль так же, как временные параметры, но задаётся программно — скриптами и git-хуками. Общий env.json остаётся нетронутым; файл под .gitignore (если строки нет — расширение предложит добавить).
{
"--ibconnection": "/F./build/${gitBranch}",
"--db-user": "admin"
}Приоритет: временные параметры > env.local.json > активный профиль. Применяются те же пять опций, что у временных параметров; прочие ключи пропускаются с пометкой в журнале. Файл читается на лету — правка git-хуком действует сразу.
Когда перекрытия активны, у профиля в статус-баре появляется *, а в панели «Профиль запуска» — строка Локальные перекрытия (клик открывает файл).
Секции команд при создании профиля
При создании базового профиля расширение предлагает отметить опциональные секции (базовые настройки подключения добавляются всегда):
- vanessa — сценарные тесты Vanessa Automation (BDD/feature);
- xunit — дымовые тесты xUnit;
- yaxunit — модульные тесты YAxUnit;
- syntax-check — синтаксический контроль конфигурации.
Секции добавляют в файл готовые блоки настроек в формате установленного vrunner (плоские секции в env.json, каскад vrunner.test.* / vrunner.validate.* в autumn-properties.json), которые ссылаются на файлы из каталога tools/.
Редактор профиля
Файл настроек можно править как JSON вручную или через форму-редактор: пункт Открыть редактор профиля в меню профиля либо клик по строке «Файл настроек» на панели «Профиль запуска» открывает env*.json / autumn-properties*.json в удобной форме.
Опции сгруппированы по смыслу (Подключение, Платформа, ibcmd и СУБД, ibsrv, EDT, Хранилище, Кластер, Vanessa, xUnit, синтаксический контроль, Запуск); нестандартные и редкие — в свёрнутой группе «Прочее».
Добавить параметр и Команда… — выбор из известных опций через QuickPick с поиском по описанию; для 3.x параметры можно задавать пер-командно (каскад
vrunner.<команда>).Правки пишутся в файл сразу, кнопки «Сохранить» нет. Форматирование и комментарии JSON остаются на месте, переключение между формой и текстом ничего не теряет.
Где применяется активный профиль
Профиль — единая точка настройки: его учитывают все пути расширения.
- Команды vanessa-runner —
--settingsактивного профиля подставляется централизованно; временные параметры и версия платформы берутся из профиля. - Панель тестирования — vanessa/xunit/yaxunit и синтаксический контроль запускаются под активным профилем, пути отчётов читаются из его файла настроек (с учётом схемы).
- Автономный сервер (ibsrv) — публикует ИБ активного профиля и его версию платформы; при смене профиля предлагает перезапуск, если работает на другой базе.
- Отладка 1С — строка подключения, учётные данные и версия платформы берутся из активного профиля.
Настройки
1c-platform-tools.env.defaultProfile— идентификатор профиля по умолчанию (имяXизenv.X.json/autumn-properties.X.json; пусто — базовый). В отличие от локального выбора, это значение можно закоммитить как общекомандный дефолт; локальный выбор его переопределяет.
Связанные руководства
- Служебные файлы — создание файла профиля и файлов
tools/*. - 1С: Инструменты — команды vanessa-runner, к которым применяется активный профиль.
- Тестирование, Автономный сервер, Отладка — подсистемы, учитывающие профиль.