Профили запуска

Профиль читают сами инструменты, расширение его не переписывает.

Запуски в проекте настраивают две вещи в корне проекта, у каждой свой элемент в строке состояния:

• профиль запуска — файл настроек vanessa-runner (env.json или autumn-properties.json): база и параметры команд. Его получают команды vanessa-runner, тесты 1С, отладка и автономный сервер. У проекта OneScript профиль — файл настроек приложения на Осени;
• окружение — переменные среды из файлов .env. Его получает любой запуск проекта, в том числе тесты и задачи OneScript.

Формат зависит от версии 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С: Администрирование.

Окружение

Переменные среды лежат в файлах .env в корне проекта. Файлы накладываются друг на друга, следующий перекрывает предыдущий:

Файл	Когда действует
.env	всегда
.env.local	всегда, личный
.env.<имя>	когда выбрано окружение <имя>
.env.<имя>.local	когда выбрано окружение <имя>, личный

Окружения — это файлы .env.<имя>; образцы .env.example, .env.sample, .env.template и .env.dist окружениями не считаются. Переменная из файла перекрывает одноимённую переменную VS Code. Выбор окружения у каждого проекта свой и в репозиторий не попадает.

Формат — dotenv: ИМЯ=значение, комментарии #, кавычки, многострочные значения, ссылки ${ИМЯ} и ${ИМЯ:-запасное}. Имена могут быть на кириллице, так задаются и настройки приложений на Осени (mutatos_КаталогиТестов=tests).

Шаблон .gitignore расширения исключает .env, .env.local и .env.*.local — пароли и личные адреса кладите туда. Файлы .env.<имя> можно хранить в репозитории и поднимать ими то же окружение в CI.

Переменные получает и контейнер Docker. В интерфейсе и в ответах агенту видны только имена переменных, без значений.

Базу, пользователя, пароль и версию платформы можно задать переменными vanessa-runner: VRUNNER_IBCONNECTION, VRUNNER_DBUSER, VRUNNER_DBPWD, VRUNNER_V8VERSION у 3.x, у 2.x — те же имена с префиксом RUNNER_. Они сильнее файла настроек и слабее временных параметров.

Выбор и создание окружения

Элемент $(variable-group) <окружение> в строке состояния показывает выбранное окружение, без выбранного — «По умолчанию», без файлов .env и .env.local — «Нет файла окружения». Он подсвечен, когда выбранного окружения нет в проекте или его файл не читается. Клик по нему или по строке «Окружение» на плашке открывает меню 1С: Окружение:

• По умолчанию и окружения проекта — выбор (отмечен $(check)); справа файлы.
• Открыть <файл> — свой файл выбранного окружения, без выбора — .env; файла нет — создаёт его.
• Создать окружение… — спрашивает имя, создаёт .env.<имя> и выбирает его.

Новый файл окружения сразу перечисляет закомментированными строками переменные, которые читает код проекта на OneScript: раскомментируйте нужные и задайте значения.

Если выбранного окружения нет в проекте, запуски не начинаются, а сообщение предлагает выбрать другое.

Проект OneScript

У проекта OneScript профиль один — autumn-properties.json, его читает само приложение на Осени. Режимы запуска задаёт окружение: переменные среды Осень ставит выше файла настроек. Например, для тестов с внешней базой:

# .env
DB_HOST=localhost

# .env.ci
DB_HOST=db.ci.local
DB_NAME=tests

По умолчанию тесты идут с .env, в окружении ci — с базой CI. Пароль DB_PASSWORD — в .env.ci.local.

Панель «Профиль запуска»

Под панелью «Команды» находится плашка Профиль запуска. В ней — что именно видят команды:

• Профиль — активный профиль (клик открывает выбор). Если выбранного профиля нет в проекте, пункт подсвечен предупреждением.
• vanessa-runner: <версия> — определённая версия и синтаксис (2.x/3.x); клик — определить версию заново (после переустановки раннера).
• Файл настроек — базовый файл схемы. Если файла нет, он не читается или записан в формате другой версии vanessa-runner, пункт подсвечен предупреждением, команды заблокированы, а подсказка говорит почему; клик создаёт файл или открывает его.
• Окружение — выбранное окружение; в подсказке файлы и имена переменных. Клик открывает выбор окружения.
• ИБ — строка подключения из файла настроек.
• Временные параметры — разовые переопределения (см. ниже).

У проекта OneScript в плашке профиль, autumn-properties.json, если он есть, и окружение.

Статус-бар и выбор профиля

В статусной строке слева — элемент $(rocket) <профиль>, у проекта любого вида. У проекта 1С и EDT он подсвечен предупреждением, когда команды блокирует профиль: базового файла настроек нет, файл не читается или записан в формате другой версии vanessa-runner, либо выбранного профиля нет в проекте. Клик открывает меню 1С: Профиль запуска:

• Список профилей — выбор активного (отмечен $(check)); справа файл профиля.
• Создать профиль… — спрашивает идентификатор, создаёт env.<id>.json / autumn-properties.<id>.json и делает его активным.
• Открыть редактор профиля — форма-редактор файла настроек.
• Временные параметры / Сбросить параметры — см. ниже.
• Определить версию — перечитать версию vanessa-runner.

Как раннер читает файл настроек из корня проекта сам, базовый профиль не требует --settings — расширение добавляет --settings <файл> только для именованного профиля. Активный профиль у каждого проекта свой и в репозиторий не попадает.

Временные параметры

Поверх активного профиля можно задать разовые переопределения отдельными флагами — они применяются ко всем командам vrunner, не меняя файл профиля:

Параметр	Флаг vrunner
Строка подключения к ИБ	--ibconnection (файловая /F<путь>, серверная /S<сервер>\<имя_ИБ>)
Пользователь ИБ	--db-user
Пароль ИБ	--db-pwd
Версия платформы	--v8version
Дополнительные параметры	--additional

Заданы только непустые поля — остальное берётся из файла профиля. Когда переопределения активны (временные параметры или 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 остаются на месте, переключение между формой и текстом ничего не теряет.

Где применяются профиль и окружение

Профиль — единая точка настройки: его учитывают все пути расширения. Окружение получает каждый запуск проекта, в том числе тесты и задачи OneScript.

• Команды 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, к которым применяется активный профиль.
• Тестирование, Автономный сервер, Отладка — подсистемы, учитывающие профиль.