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

> Статус, проверка связи, журнал, обновление версии, выключение, отзыв и удаление.

## Где что видно

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

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

_Иллюстрация: В приложении: онлайн/офлайн, обслуживаемые репозитории, установленные интеграции._

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

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

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

```bash
connector instance check jira_prod
```

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

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

```bash
connector instance log jira_prod
```

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

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

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

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

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

```bash
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
```

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

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

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

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

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

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

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

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

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

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

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

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

Отзыв коннектора — не то же самое, что
[отзыв версии интеграции](/docs/connector/marketplace#отзыв-версии): второй касается
кода, первый — доступа этого агента.

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

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

Копия импортированного кода остаётся у нас — её удаление по письменному запросу
владельца организации описано в [«Безопасности»](/docs/security).