Компоненты

Раннер ничего не делает с базой сам: он оркестрирует чужие процессы — утилиты платформы и EDT. Здесь перечислено, из чего состоит система, кто с кем разговаривает и по какому каналу, и как раннер выбирает исполнителя на каждую операцию.

• Из чего состоит система
• Кто с кем говорит
• Цели: два адреса
• Исполнители
• Выбор исполнителя
• Что доступно по виду цели
• Внутри раннера
• Сколько живёт

Из чего состоит система

Словарь инструментов объясняет названия утилит и сервисов и отмечает, какими процессами управляет раннер.

Платформа называет пять компонентов: информационная база, клиентское приложение, сервер (кластер), СУБД и веб-сервер (51). К ним раннер добавляет утилиты, которыми с этими компонентами разговаривают, и свои собственные части.

Как раннер устроен по осям: формат и тип исходников → операция → вид цели → исполнитель по матрице умолчаний. Первые три называет вызывающий, четвёртое решает раннер.

Кто с кем говорит

Раннер запускает утилиты у себя и подключается к цели через файлы, сетевой протокол платформы, SSH или прямой доступ к СУБД. Автономный сервер достижим двумя из них: Конфигуратор идёт в его прямой шлюз тем же протоколом, что в кластер (65), а SSH ведёт в агентский шлюз (61). При работе через кластер базу создаёт Конфигуратор, передавая кластеру реквизиты СУБД в строке создания (73). Прямой доступ ibcmd к СУБД кластерной базы допустим только после остановки всех серверных процессов кластера, которые работают с этой базой; завершения сеансов недостаточно. Раннер не останавливает кластер автоматически. Применять ibcmd или ibsrv к базе работающего кластера нельзя: это может разрушить данные (60). Консоль кластера остаётся вне раннера; к серверу администрирования он ходит только за сеансами своей базы. Здесь показан только канал администрирования; чем и откуда базу открывает человек, видно в каждом варианте отдельно.

Утилиты EDT к базе не подключаются: 1cedtcli работает только с исходниками, поэтому во всех четырнадцати расстановках он одинаков.

Четырнадцать способов расставить это по машинам — на странице Расстановки.

Цели: два адреса

У базы два адреса. По строке подключения раннер её администрирует, и по ней же базу открывают Конфигуратор, толстый и тонкий клиент. По веб-адресу её открывают веб-клиент и тот же тонкий клиент: у тонкого клиента два пути, у веб-клиента один, у толстого клиента и Конфигуратора только строка (67). Адрес вида ws=… — веб-адрес, и он не говорит, чем администрировать: за публикацией может стоять файловая база, кластер или автономный сервер.

Кластер и автономный сервер могут стоять на другой машине, и их файловая система раннеру недоступна. Поэтому workPath всегда локален, пути в командах, адресованных цели, разрешаются на её стороне, а результат с удалённой цели, которую исполнял SSH-шлюз, забирается объявленным каналом обмена, а не чтением чужого пути. Конфигуратор по сети — в кластер или в прямой шлюз — читает и пишет файлы у раннера. Режим, где раннер сам поднимает процесс, работает только с локальной точкой входа.

Следствие для диагностики: журнал платформы на стороне цели и технологический журнал сервера раннеру не видны — квитанция их не обещает.

Ключи базы здесь и ниже записаны от её секции: web.url значит infobases.<имя>.web.url. Веб-адрес живёт в web.url: у автономного сервера он известен сразу, у остальных появляется после публикации.

Исполнители

Проза инструмента никогда не решает — только переносится как улика.

Выбор исполнителя

1. Умолчания заданы нами и живут в коде — матрица (операция, цель) → цепочка.
2. Раннер берёт первого готового в этом окружении.
3. providers.<операция> в конфиге переопределяет жёстко: неготовый — отказ, без отката.
4. На проводе и во флагах исполнителя нет: вызывающий его не выбирает.
5. Квитанция объясняет выбор: selected, origin, skipped.

Назначить исполнителя жёстко

Ключ providers.<операция> в v8project.yaml или в местном слое назначает исполнителя на одну операцию и отменяет цепочку умолчаний: если названный исполнитель не готов, команда отказывает и следующего не берёт. Другого выключателя нет: ни флага, ни переменной окружения, ни состояния на диске.

providers:
  push: agent
  pull: agent

Квитанция показывает, кто исполнил и почему: provider.selected называет исполнителя, provider.origin.kind: override — что его назначил ключ. Валидация отвергает ключ там, где выбирать не из чего: например, у автономного сервера, объявленного одним SSH-шлюзом, исполнитель один. Там, где названный исполнитель операцию не реализует, отказ называет, кто её реализует.

Агент: два режима

Тот же принцип у сервера администрирования: объявленный cluster.ras раннер только использует, а без него поднимает ras сам, на своей машине, против агента кластера из строки подключения, и гасит вместе с командой (55).

Правила

Unica вызывает командную строку с --json-message.

Что доступно по виду цели

Первый исполнитель в клетке — умолчание; если он не готов в этом окружении, раннер берёт следующего. Ключ providers.<операция> назначает исполнителя жёстко. Столбец кластера описывает подключение по Srvr=…;Ref=…: через него работают Конфигуратор и агент. Прямое подключение ibcmd по dbms — канал к СУБД при остановленном кластере. С работающим кластером такой доступ запрещён из-за риска разрушения базы (60); наличие канала само по себе не определяет выбор исполнителя для операции. Регистрировать базу в кластере ibcmd не умеет (74). У автономного сервера первым стоит Конфигуратор по прямому шлюзу: полный набор команд, файлы у раннера (65); SSH-шлюз берётся, когда строка подключения не объявлена или его назначил ключ, и набор у него урезан (61).

У тонкого клиента два пути, и раннер умеет оба: по строке подключения — прямо в файловую базу, в кластер или в прямой шлюз автономного сервера, по веб-адресу — через Apache, IIS или HTTP автономного сервера. Без ключа launch thin берёт строку подключения; веб-адрес — когда строка не объявлена. Ключ --via web|connection умолчание переопределяет и принимается только там, где клиент тонкий: через веб-сервер ходят тонкий, веб- и мобильный клиенты, толстый и Конфигуратор — только по строке подключения (67); launch web открывает тот же веб-адрес браузером. ibcmd серверную цель открывает прямо в СУБД, мимо кластера, по секции dbms; у файловой базы ему хватает пути к каталогу, а у автономного сервера секция не принимается вовсе. Какие строки помечены экспериментальными и как их включить — в разделе Эксперименты.

Каналы и протоколы

Внутри раннера

Слои раннера и процессы, которые он запускает.

Слои

Процессы

Сколько живёт

Что из этого следует

• Сессия EDT завершается вместе с командой.
• Пока команда владеет workPath, она работает с одним агентом, и вложенные шаги идут в нём же. Живой агент остаётся и после команды: следующая команда той же рабочей копии берёт его без подъёма.
• Живой агент и его сторож держат всё своё в workPath/agent/live: вне рабочей копии раннер ничего не создаёт. Пока агент жив, каталог занят — уборка рабочей копии начинается с agent stop.
• Память о прошлом разе переживает процессы — она лежит на диске под localPath, и удаление workPath её не стирает.
• Параллельные команды на одном workPath не выполняются: вторая ждёт замок.