Фиксированный профиль
Администратор ноды задаёт профиль локально у агента. Пример фрагмента конфигурации отдельного Telepúrte Agent:uptime. Не используйте такое разрешение в роли «только состояние».
Права и запуск
Для оператора требуется разрешение на конкретный профиль и ноду; обычный SSH-грант и право на типизированную операцию не заменяют его. Локальная политика агента также обязательна. Контракт управляемых команд доступен через API/api/v1/commands: сначала previews, затем runs с ID предпросмотра. Предпросмотр показывает точный профиль, параметры, цели и партии. Он не выполняет команду. Массовый запуск поддерживает канарейку, размер партии и порог ошибок.
Если профиль, политика или права изменились, сформируйте новый предпросмотр. Сохраните ID запуска и проверяйте результаты каждой цели, а не повторяйте запрос с новым ID при непонятном сетевом сбое.
Произвольный shell агента
Для ad hoc режима на ноде явно разрешают профильadhoc с /bin/sh и пустыми аргументами. Он выполняет переданный текст через shell; сам факт появления профиля не выдаёт право пользователю.
Этот режим не интерактивный: stdin закрыт, рабочий каталог начинается с /, окружение и текущий каталог не сохраняются между запусками. Срок профиля ограничен 30 секундами, текст команды — 1 МиБ. Для долгой повторяемой работы используйте скриптовый плейбук, для интерактивной — терминал.
Вывод и неопределённый результат
Агент сохраняет до 4096 байт совокупного stdout/stderr. В результате есть код завершения, контрольная сумма и признак обрезки. Если вывод обрезан, остальная часть не появится при повторном чтении того же результата. Потеря подтверждения изменяющего запуска даётexecution_uncertain; автоматического повтора команды нет. Проверьте фактическое состояние ноды. Чтение сохранённого вывода не выполняет команду повторно и фиксируется в аудите.
Запрет и остановка
Администратор может запретить профиль на одной ноде или во всей установке. Запрет действует поверх разрешений, в том числе при выдаче ожидающего задания агенту. Уже выданная команда может закончиться. Остановка запуска прекращает будущую выдачу; она не равна отправкеCtrl-C уже работающему процессу. Запрет профиля не фильтрует команды внутри интерактивного SSH и не блокирует автоматически другие способы выполнения.
Проверка
Начните с читающего профиляstatus на одной ноде. Проверьте точный профиль в предпросмотре, код завершения, вывод и аудит. Для нескольких нод сравните определения профиля и их политики до запуска.
