Перейти к основному содержанию
В Telepúrte несколько способов выполнить команду. Выбирайте по задаче и нужной модели доступа: интерактивный терминал, повторяемый плейбук, разрешённый профиль агента или разовый shell.

Фиксированный профиль

Администратор ноды задаёт профиль локально у агента. Пример фрагмента конфигурации отдельного Telepúrte Agent:
Это дополнение существующего файла, не замена всей конфигурации. После изменения проверьте конфигурацию, перезапустите агент и дождитесь обновления его состояния в панели. Оператор выбирает профиль, но не подставляет произвольные аргументы. На всех целях массового запуска профиль с этим ID должен иметь одинаковые бинарник, аргументы и срок. Исполняемый файл должен существовать и не быть доступным на запись посторонним. Профиль интерпретатора или универсальной обёртки фактически расширяет возможности гораздо сильнее, чем профиль 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 на одной ноде. Проверьте точный профиль в предпросмотре, код завершения, вывод и аудит. Для нескольких нод сравните определения профиля и их политики до запуска.

Откат

Отзовите грант, удалите ненужный профиль из локальной политики или установите запрет, затем дождитесь обновления состояния агента. Изменения, выполненные командой, возвращаются отдельно; отключение профиля их не отменяет. Расширенные параметры, обозначенные как API, могут отсутствовать в текущей форме интерфейса.