Перейти к основному содержанию
Агент выполняет операции на ноде и сообщает о её состоянии. Он нужен для мониторинга, автоматизации, подготовки управляемых Linux-учёток и агентного SSH-туннеля. Наличие агента не выдаёт пользователям права: доступ Telepúrte и локальные разрешения ноды проверяются вместе.

Два варианта подключения

Для импортированных нод используется Axottle Agent с отдельной привязкой к Telepúrte. Подключение запускается из Импорт Axottle; не требуется ставить второй агент только ради интеграции. Для автономной ноды предусмотрен отдельный Telepúrte Agent. Он устанавливается из подписанной поставки и регистрируется одноразовым кодом, связанным с нужной нодой. Не переносите конфигурацию с идентичностью одного сервера на другой.

Что смотреть в панели

Раздел Агенты и вкладка Агент в карточке ноды показывают связь, версию и готовность. Сверьте, что выбран именно агент нужной машины. Состояние online означает недавнее сообщение, но не подтверждает поддержку всех новых действий. Перед работой проверьте отдельно:
  • присутствие ноды и правильную привязку агента;
  • время последнего сообщения;
  • версию и поддержку нужного действия;
  • локальное разрешение на конкретный ресурс;
  • результат SSH-подготовки, если нужен терминал;
  • состояние личных или временных учёток, если вход идёт через них.

Подключение отдельного Telepúrte Agent

Возьмите install-agent.sh и комплект одной версии из официальной поставки. Как и для панели, сначала выполните --dry-run, затем установку с выбранной версией и --bundle. Установщик сохраняет конфигурацию и ключи при обновлении. Создайте приватную конфигурацию /etc/telepurte-agent/config.json с адресом панели control_origin, ID установки instance_id, ID ноды host_id и путями файлов идентичности. Используйте значения именно вашей установки. Файл должен принадлежать сервисному пользователю и иметь режим 0600. Полученный код регистрации поместите в защищённый файл, доступный telepurte-agent, и выполните:
Не передавайте код в аргументе процесса или URL. После регистрации клиент удаляет файл кода. Локальная команда check проверяет файлы, а серверный online появится после связи с панелью.

Разрешения на операции

Это настройки отдельного Telepúrte Agent; у интегрированного Axottle Agent используйте его поддерживаемую процедуру настройки. Не заменяйте целиком существующую конфигурацию примером фрагмента. Разрешение в списке не повышает права Linux. Для привилегированных типизированных действий нужны соответствующие локальные помощники с собственной политикой. Для записи файла нужны также права на каталог и разрешение записи в системных ограничениях службы. Пустые списки не следует трактовать как «разрешено всё».

SSH-подготовка

Агентная подготовка настраивает доверие SSH и подтверждает ключ ноды. Обычный heartbeat не заменяет эту процедуру. Ошибки ca_conflict или config_conflict означают, что существующие настройки нужно разобрать перед заменой. При незавершённой изменяющей операции со статусом неопределённого результата сначала проверьте фактический sshd и доверие на машине. Слепой автоматический повтор может перезаписать уже изменившееся состояние. Для импортированных нод предусмотрена явная массовая замена прежней SSH CA в разделе агентов. Выполняйте её только после проверки состава целей и совместимости Axottle Agent; подробности связи — здесь.

Обновление

Обновление панели Telepúrte не обновляет автоматически отдельные агенты. Если действие требует новой возможности, сначала обновите агент поддерживаемым для его типа способом, дождитесь свежего сообщения и повторите предпросмотр задания. Изменение политики после предпросмотра может дать policy_changed: создайте новую проверку целей. Это ожидаемая защита от выполнения по устаревшим разрешениям.

Проверка

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

Откат

Верните прежнюю локальную политику и перезапустите агент, отзовите ошибочную регистрацию в панели. Не удаляйте идентичность без необходимости: для повторной регистрации нужны согласованные действия на ноде и в Telepúrte. Уже выполненные операции откатываются отдельно. Набор экранов и действий зависит от версии компонентов и действующих прав.