Настройка
Страница параметров EDT-Bridge в EDT, переменные окружения EDT_BRIDGE_* обвязки и плагина, граница записи.
Плагин читает настройки со страницы параметров EDT-Bridge в EDT, из переменных окружения
EDT_BRIDGE_* и из свойств запуска -Dedt.bridge.*. Обвязка читает переменные окружения
и флаги командной строки.
Настройки в самой EDT
Страница параметров плагина находится в разделе Окно ▸ Параметры ▸ EDT-Bridge. Здесь можно указать токен для моста, работающего внутри EDT с интерфейсом:
| Параметр | Что это |
|---|---|
| Токен для инструментов записи | Общий секрет, который требует каждый инструмент записи. Пустой токен означает, что запись запрещена, а не что она открыта всем. Клиенту передается то же значение под именем EDT_BRIDGE_TOKEN. |
| Порт MCP-сервера | По умолчанию 8770. Вступает в силу после перезапуска EDT, а до перезапуска работающий сервер держит прежний порт. |
| Разрешить выполнение произвольного кода BSL при отладке | По умолчанию выключено. Этот переключатель закрывает edt_evaluate, который исполняет код против живой информационной базы. Только тестовые стенды. |
Системные свойства -Dedt.bridge.* и переменные окружения EDT_BRIDGE_*, заданные при запуске,
имеют приоритет над сохраненными параметрами. Обвязка использует их для управления headless EDT.
Если токен указан при запуске, значение со страницы параметров не применяется.
Переменные окружения
Настройки у обвязки и у плагина называются одинаково, EDT_BRIDGE_*, но читают их разные стороны:
обвязка при своем запуске, плагин внутри EDT. У большинства настроек обвязки есть флаг-двойник, он
описан в Командах.
Читает обвязка edt-bridge-mcp
| Переменная | Флаг | По умолчанию | Что задает |
|---|---|---|---|
EDT_BRIDGE_PORT |
--port |
8770 |
порт, на котором обвязка ищет мост |
EDT_BRIDGE_PORT_SCAN |
– | 20 |
сколько портов подряд начиная с этого просматривать. Занятый порт плагин отдает следующему свободному, и в этом же окне мост потом ищется |
EDT_BRIDGE_TOKEN |
– | пусто | токен инструментов записи. Передается в заголовке Authorization: Bearer и передается в JVM headless-экземпляра |
EDT_BRIDGE_WORKSPACE |
--workspace |
– | рабочая область EDT для автоматического запуска headless |
EDT_BRIDGE_EDT_DIR |
--edt-dir |
самая свежая установка | каталог установки EDT (папка с 1cedtcli и dropins). Без него берется установка с самым свежим eclipse.buildId в configuration/config.ini, а если его там нет – по версии в имени каталога. Если в ini нет -vm, а версия Java из PATH ниже требуемой, мост ищет подходящий JDK в JAVA_HOME, затем среди компонентов установщика 1С. В процессе EDT мост задает JAVA_HOME для выбранного JDK и ставит его первым в PATH |
EDT_BRIDGE_START_TIMEOUT |
--start-timeout |
360 |
сколько секунд ожидать запуск моста |
EDT_BRIDGE_AUTOSTART |
--no-autostart |
включен | 0 – не запускать EDT и только пересылать запросы. Отказ “not running” приходит, только когда порт никто не слушает. Если мост уже отвечал, а под тяжелыми вызовами стал отвечать медленно, вызов все равно уходит к нему и ждет своей очереди |
EDT_BRIDGE_HEAP |
--heap |
из установки EDT | наибольший размер кучи JVM для автоматически запущенной headless EDT: число с k, m или g, например 6g. Передается как -Xmx и заменяет значение из ini-файла установки |
EDT_BRIDGE_VMARGS |
--vmargs |
– | другие параметры JVM для автоматически запущенной headless EDT через пробел, например -XX:+ExitOnOutOfMemoryError -Xlog:gc:file=gc.log. Каждый параметр начинается с дефиса, порт моста задает EDT_BRIDGE_PORT |
EDT_BRIDGE_WINDOW_WAIT |
– | 90 |
сколько секунд команда gui ждет появления окна EDT. Загрузка большой рабочей области может занять несколько минут; если окно не появилось, команду можно повторить |
EDT_BRIDGE_LANG |
– | язык системы | язык справки и сообщений обвязки (ru или en) |
EDT_BRIDGE_NO_PLUGINS |
– | выкл | 1 – не искать плагины обвязки, оставить только штатные возможности |
EDT_BRIDGE_TOOLSET |
– | все инструменты | набор инструментов или несколько через запятую: processor, report, extension. Обвязка перечисляет и вызывает только их инструменты, включая свои и инструменты плагинов. Неизвестное имя приводит к отказу в списке и в каждом вызове |
EDT_BRIDGE_WRITE_PROJECTS, EDT_BRIDGE_READ_PROJECTS, EDT_BRIDGE_OUTPUT_DIR |
– | – | граница записи, которую ждет обвязка. EDT, запущенная обвязкой, получает ее по наследству, а вызов к EDT с другой границей получает отказ, пока они не совпадут |
EDT_BRIDGE_PLUGIN_INDEX |
– | – | адрес реестра пакетов, который self-update передает pip для плагинов, установленных по имени проекта. У плагина, поставленного из git, источник свой |
Читает плагин внутри EDT
| Переменная | Свойство запуска | По умолчанию | Что задает |
|---|---|---|---|
EDT_BRIDGE_PORT |
-Dedt.bridge.port |
8770 |
порт MCP-сервера. Если он занят, берется следующий свободный |
EDT_BRIDGE_TOKEN |
-Dedt.bridge.token |
со страницы параметров | общий секрет, который требует каждый инструмент записи |
EDT_BRIDGE_ALLOW_EVALUATE |
– | выключено | 1 разрешает edt_evaluate – исполнение произвольного BSL против живой информационной базы. То же самое включается на странице параметров |
EDT_BRIDGE_AGENT_IDLE_MINUTES |
-Dedt.bridge.agent-idle-minutes |
30 |
через сколько минут простоя агент конфигуратора останавливается сам. off – держать вечно |
EDT_BRIDGE_DUMP_INFOBASE |
– | – | файловая база (каталог, ее 1Cv8.1CD или File="...";) с базовой конфигурацией внешних объектов. Маршрут edt_dump_external_object через платформу на диске собирает в ее копии, и типы базовой конфигурации разрешаются; без нее сборка идет в пустой базе. edt_build_extension тоже импортирует расширение в ее копию: заимствованная форма, исключившая команды основного реквизита (Post, Write), и типы базовой конфигурации проверяются по этой конфигурации |
EDT_BRIDGE_TEST_INFOBASE |
– | – | файловая база с тестовыми данными для edt_test_form и edt_unit_tests; каждый запуск работает со свежей копией ее 1Cv8.1CD; для edt_unit_tests в ней нужно расширение YAXUNIT |
EDT_BRIDGE_TEST_PLATFORM |
– | – | каталог bin платформы с 1cv8 и ibcmd, которую запускают edt_test_form и edt_unit_tests |
EDT_BRIDGE_TEST_USER |
– | – | пользователь базы для edt_test_form и edt_unit_tests, если в тестовой базе есть пользователи |
EDT_BRIDGE_TEST_WEB_HTTPD |
– | /usr/local/apache2/bin/httpd |
исполняемый файл Apache 2.4 для снимков веб-клиента с маской |
EDT_BRIDGE_TEST_CACHE |
– | ~/.cache/edt-bridge/test-manager |
где test-form и edt_test_form хранят готовую служебную базу каждой сборки платформы, чтобы ее создавала только первая проверка сборки; off готовит ее для каждой проверки. Образ стенда может нести уже заполненный каталог; см. Подготовка окружения |
EDT_BRIDGE_PLATFORM |
– | C:\Program Files\1cv8\8.5.1.1529\bin |
установка 1С:Предприятия 8.5, из которой edt_form_render берет значки и шрифты веб-клиента; по умолчанию самая новая из установленных. Параметр вызова platformPath важнее |
EDT_BRIDGE_ASSET_CACHE |
– | ~/.cache/edt-bridge/client-assets |
где edt_form_render хранит значки и шрифты, прочитанные из сборки платформы, чтобы файлы платформы читала только первая отрисовка сборки |
EDT_BRIDGE_TOOLSET |
-Dedt.bridge.toolset |
все инструменты | те же наборы на стороне моста: tools/list возвращает только их инструменты, вызов другого инструмента отклоняется с перечнем наборов, в которые он входит. edt_tool_help называет наборы любого инструмента, /status – действующие наборы. Описания и подсказки валидации отмечают инструменты вне действующих наборов при первом упоминании: (outside the active tool set 'report': a call of it is refused) |
EDT_BRIDGE_WRITE_PROJECTS |
-Dedt.bridge.write.projects |
все проекты | проекты, которые инструменты могут менять, через запятую; см. Граница записи |
EDT_BRIDGE_READ_PROJECTS |
-Dedt.bridge.read.projects |
– | проекты, которые инструменты могут только читать |
EDT_BRIDGE_OUTPUT_DIR |
-Dedt.bridge.output.dir |
любой | абсолютный каталог, в котором должны лежать файлы, записанные инструментами |
EDT_BRIDGE_PII |
-Dedt.bridge.pii |
off |
redact или pseudonym убирает персональные данные из ответов с данными базы, в мосте и в обвязке; см. Персональные данные |
EDT_BRIDGE_PII_SALT |
-Dedt.bridge.pii.salt |
своя на процесс | секретная соль псевдонимов: с ней одинаковое значение получает одинаковый псевдоним в любом сеансе |
EDT_BRIDGE_PII_RULES |
-Dedt.bridge.pii.rules |
– | файл JSON со своими правилами: values (kind и pattern) и names (kind и шаблон имени поля pattern) |
Граница записи
Набор инструментов ограничивает, какие инструменты работают, но не то, куда они пишут. Агента
ограничивают три настройки: проекты, которые он может менять (EDT_BRIDGE_WRITE_PROJECTS), проекты
только для чтения (EDT_BRIDGE_READ_PROJECTS) и каталог для файлов, которые пишут инструменты
(EDT_BRIDGE_OUTPUT_DIR). Мост проверяет каждый вызов до запуска инструмента, поэтому клиент,
который обращается к порту напрямую, упирается в ту же границу. Отказ называет разрешенное.
Если списки проектов заданы, инструмент с пометкой WRITE меняет только проект из первого списка, а
читать любой инструмент может только проекты обоих списков; инструменту, который без проекта читает
все проекты, нужен projectName. Новое расширение или внешний объект получает имя из первого
списка. Файлы, которые пишут инструменты, – targetPath, logPath, outputPath, outPath и
каталог новой базы – должны лежать в каталоге результатов; как только задана любая из настроек,
файл больше никуда не пишется. modulePath не может выходить за пределы своего проекта. /status
сообщает границу, которую держит мост.
Настройки попадают в EDT через окружение ее процесса: EDT, запущенная обвязкой, получает их по наследству. Если настройки есть у обвязки, а работающая EDT сообщает другую границу, обвязка отказывает в вызовах, пока EDT не перезапустят с теми же настройками.
Персональные данные
Если задана EDT_BRIDGE_PII, ответы с данными базы до отправки очищаются от персональных
данных, и в плагине, и в обвязке. Какие инструменты это затрагивает, как фильтр находит данные,
псевдонимы, свои правила и поля отфильтрованного ответа описаны на странице
Персональные данные.