Управление и удаление

Где что видно

В приложении (раздел «Коннекторы») — взгляд владельца: агенты онлайн или офлайн, какие репозитории обслуживают, какие подключения работают, что они отдали модели и куда им разрешено ходить. Статус обновляется сам.

На локальной странице агента — взгляд оператора: то же самое плюс всё, что можно изменить, и журналы. Управление живёт только здесь: установка кода в вашей сети — ваше решение, приложение за вас его не принимает.

Проверка связи

«Проверить связь» у подключения ходит в вашу систему прямо сейчас и отвечает не «ок», а тем, что нашёл: версией и редакцией сервера, учётной записью, под которой вошли, числом репозиториев или проектов в области. Так видно, что настроено именно то, что нужно, — а не то, что «ошибок нет».

То же командой:

connector instance check jira_prod

Журнал подключения

«Журнал» показывает, что происходило в подключении: запуск, ошибки, исходящие запросы (метод, адрес, код ответа, длительность и имя учётных данных — не значение). Первое место, куда смотреть, когда бот молчит.

connector instance log jira_prod

Изменения без перезапуска

Добавить репозиторий, сменить токен, поправить список проектов — всё применяется на лету. Перезапускается только то, что действительно изменилось: коннектор сверяет отпечаток подключения и трогает лишь те процессы, чьи настройки поменялись.

Переименование ничего не перезапускает и ничего не ломает: ни ссылка вебхука, ни история списаний к названию не привязаны.

Обновление версии интеграции

Подключение закреплено за версией. Когда установлена более свежая, у подключения появляется кнопка «Обновить до …». Перед переключением коннектор проверяет, что настройки этого подключения подходят новой версии, и отказывается, если чего-то не хватает, — вместо подключения, упавшего после обновления.

connector install jira@1.4.1 --config /etc/connector/connector.yaml
connector instance set jira_prod --version 1.4.1 --config /etc/connector/connector.yaml

Старая версия остаётся на диске: откат — это смена версии обратно.

Выключить, не удаляя

connector instance disable jira_prod --config /etc/connector/connector.yaml
connector instance enable  jira_prod --config /etc/connector/connector.yaml

Выключенное подключение остаётся настроенным, но не работает: процесс останавливается, события не читаются. Удобно, когда трекер на обслуживании.

Удаление подключения

«Удалить» на локальной странице или:

connector instance rm jira_prod --config /etc/connector/connector.yaml --dry-run
connector instance rm jira_prod --config /etc/connector/connector.yaml

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

Обновление агента

Скачайте новую версию, проверьте подпись и замените исполняемый файл (или потяните свежий образ и перезапустите контейнер). Каталог состояния и конфиг сохраняются: установленные интеграции, подключения и секреты остаются на месте. Версия видна в приложении.

Отзыв доступа

В разделе «Коннекторы» — «Отозвать» у нужного агента. Связь с платформой прекращается, агент отключается. Отзыв необратим: вернуть агент в строй можно только новой привязкой.

Отзыв коннектора — не то же самое, что отзыв версии интеграции: второй касается кода, первый — доступа этого агента.

Удаление агента

1. Отзовите коннектор в приложении.
2. Остановите и удалите агент:
   • бинарь — остановите процесс (systemctl stop …) и удалите файл;
   • Docker — docker rm -f buff-connector и, при желании, docker volume rm тома состояния.
3. Удалите каталог состояния и конфиг: там ключ агента, токены git и секреты подключений.

Копия импортированного кода остаётся у нас — её удаление по письменному запросу владельца организации описано в «Безопасности».