Компонент Запуск процесса

Описание

Запускает на сервере внешний консольный процесс. Параметры передаются в теле командной строки. Возвращаемое процессом значение из консоли может быть захвачено и возвращено в переменную.

Операция должна быть предварительно разрешена и настроена в файле ассетов permissions.json на каждом сервере, где может выполняться компонент.

Table 1. Системные характеристики

Индекс

117

Краткое название

execprocess

Типы сценариев

Все

Стартовый модуль

r_script_component_execprocess

Режим

Асинхронный

Иконка

117

Характер разветвления

Разветвляющий, замыкающий

Свойства

Table 2. Свойства
Спецификация Описание

Название: Режим
Код: mode
Усл. видимости: нет
По умолчанию: Асинхронный запуск

Режим ожидания завершения процесса ОС.
Возможные значения:

  • Асинхронный запуск (async, 0) – Сразу после запуска процесса передает управление следующему компоненту.

  • Ожидание завершения (sync, 1) – Передает управление следующему компоненту только после завершения процесса или таймаута ожидания.

Название: Путь к исполняемому файлу
Код: path
Усл. видимости: нет
По умолчанию: — 

Путь к файлу или команда ОС. Префикс командной строки.
Префикс должен быть разрешен в файле permissions.json.

Примеры указания команд:

  • echo

  • myprogram1

  • /bin/myprogram2

  • :GLOBALSHARE_COMMON/cmd/myprogram3

  • bash :SYNC_COMMON/cmd/myscript.sh

Для разрешения этих примеров в файле 'permissions.json' должно быть следующее содержание:

{
  "exec_perm": {
    "check": true,
    "user": "root",
    "commands": [
      "echo",
      "myprogram1",
      "/bin/myprogram2",
      ":GLOBALSHARE/common/cmd/myprogram3",
      ":SYNC/common/cmd/myscript.sh"
    ]
  }
}

Используя bash-скрипты можно запускать любые команды, разрешение проверяется только на путь к стартовому bash-скрипту.

Название: Параметры запуска командной строки
Код: params
Усл. видимости: нет
По умолчанию: — 

Постфикс команды, содержащий параметры.

Название: Время, с
Код: timeout
Усл. видимости: да
По умолчанию: — 

Таймаут ожидания завершения процесса.

Название: Переход
Код: transfer
Усл. видимости: нет
По умолчанию: — 

Компонент, которому передается управление после асинхронного запуска, либо после успешного завершения процесса.

Название: Результат в переменную
Код: result
Усл. видимости: нет
По умолчанию: — 

Переменная для сохранения консольного вывода завершенного процесса.

Название: Переход, ошибка
Код: transferError
Усл. видимости: нет
По умолчанию: — 

Компонент, которому передается управление в случае ошибки запуска или падения процесса.

Название: Причина ошибки в переменную
Код: error
Усл. видимости: нет
По умолчанию: — 

Переменная для сохранения ошибки.

Название: Переход, время
Код: transferTimeout
Усл. видимости: да
По умолчанию: — 

Компонент, которому передается управление по истечении времени ожидания завершения процесса.

См. также