Перейти к основному содержимому
Версия: 1.21.3

Агент инфраструктуры

Агент инфраструктуры – это приложение, написанное на Go, которое может работать как сервис Windows, для упрощения коммуникации и обработки задач между экземпляром SimpleOne и внешними системами.

Концепция​

В SimpleOne коммуникация между экземпляром и пользовательской инфраструктурой (например, серверами LDAP или почты) реализуется с помощью технологии "сервер-агент".

Она используется для коллаборации, когда требуется интеграция с пользовательским программным обеспечением. Основные цели коллаборации – это:

  1. Синхронизация информации на экземпляре SimpleOne с преднастроенными шаблонами.
  2. Синхронизация информации на пользовательском экземпляре с преднастроенными шаблонами.

Шаблоны – это скрипты, которые позволяют выполнять определенные задачи.

Требования системы​

Агент и сервер требуют небольшого количества системных ресурсов, таких как ЦП, ОЗУ или место на жестком диске.

Требования к программному обеспечению​

ПОМинимальные требования к оборудованиюТребования к ПО
Агент
  • CPU: 1.4 GHz процессор 64-бит.
  • RAM: 512 МБ
  • HDD: 32 ГБ
  • Интернет-соединение: 10/100/1000 Мбит/сек
Сервер Microsoft Windows (2012r2 или выше)
подсказка

Сервер инфраструктуры настроен на экземпляре SimpleOne как запись справочника, которая включает в себя подходящую бизнес-логику со стороны сервера и клиента.

Процедура взаимодействия​

Для настройки взаимодействия выполните следующие шаги:

  1. Установите агента инфраструктуры на сервер Microsoft Windows в пользовательской инфраструктуре.
  2. Настройте сервер инфраструктуры на экземпляре SimpleOne.
  3. Настройте задачи для агента инфраструктуры.

В результате взаимодействие настроено и начинает работать. Агент отправляет запросы на сервер, чтобы получить задачи. Интервал запросов обычно составляет несколько секунд.

  1. Если нет задач для выполнения, агент выполняет дальнейшие попытки отправки запросов в настроенный интервал времени.
  2. Если есть задачи для выполнения, агент начинает их выполнять.
    • Агент соединяется с сервером для отчета о выполнении задач, независимо от того, были они завершены успешно или нет.

Схематично этот процесс выглядит следующим образом:

Настройка инфраструктурного сервера​

Чтобы добавить параметры сервера в соответствующую таблицу, выполните следующие действия:

  1. Перейдите в Серверы MID → Серверы MID.
  2. Нажмите Создать и заполните поля.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Серверы MID

ПолеОбязательноОписание
НаименованиеДаУкажите имя сервера инфраструктуры, отображаемое в списке.
Имя хостаДаУкажите имя хоста внешнего сервера, к которому необходимо подключиться. Например, mid_server.
ПользовательДаУкажите системного пользователя с доступом к функциональности агента инфраструктуры. Пользователь должен иметь роль admin.

Настройка агента инфраструктуры​

  1. Скачайте агент инфраструктуры и разархивируйте его.
  2. Создайте папку на диске С с именем MID_agent.
  3. Поместите в созданную папку скачанные файлы .exe и .env из архива.
  4. В файле .env измените значения:
ПолеОписание
MID_API_USERNAMEИмя пользователя системы с предоставленным доступом к агенту инфраструктуры.
MID_API_PASSWORDПароль соответствующего пользователя.
MID_API_SERVERIDID сервера, настроенного ранее в таблице Серверы MID.
MID_API_ENDPOINTСсылка на экземпляр SimpleOne, на котором будет работать сервер MID.

Пример заполненных значений:

  • MID_API_USERNAME=admin
  • MID_API_PASSWORD=123456
  • MID_API_SERVERID=157237947616342741
  • MID_API_ENDPOINT=https://instance.example.com/rest

Добавление скриптов​

После настройки агента инфраструктуры вам необходимо настроить для него скрипты.

  1. Перейдите в Серверы MID → Скрипты MID.
  2. Нажмите Создать и заполните поля.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Скрипты MID

ПолеОбязательноОписание
НаименованиеДаУкажите имя сервера инфраструктуры, отображаемое в списке.
ОписаниеНетВведите краткое описание скрипта.
АктивенНетУстановите флажок, чтобы активировать запись скрипта.
СкриптДаУкажите скрипт, который будет обрабатывать необходимые задачи и обязанности, связанные с соответствующей деятельностью.
подсказка

В этих скриптах вы можете использовать переменные для облегчения обмена данными между клиентской инфраструктурой и экземплярами SimpleOne.

Например, вы можете сделать это определение в своем скрипте MID:

Скрипт MID
$title='Title:\n';Write-Host($title);Write-Host($param1);

Затем значение переменной title должно быть передано в поле Запрос соответствующей записи Очереди MID:

Очередь MID: Запрос
{"param1":"String value"}

После выполнения скрипта поле Ответ в соответствующей записи Очереди MID будет равно:

Очередь MID: Ответ
Title:
String value

Настройка задачи​

Для настройки задач на элементе внешней инфраструктуры необходимо создать запись в таблице Очереди MID (sys_mid_queue). Для этого выполните следующие действия:

  1. Перейдите в Серверы MID → Очереди MID.
  2. Нажмите Создать и заполните поля.
  3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Очередь MID

ПолеОбязательноОписание
ЗапросНетВведите запрос к внешнему серверу в формате JSON.
ОтветНетОтвет сервера, содержащий выходные данные команды (ответ stdout) и другую информацию. Это поле заполняется автоматически.
ОписаниеНетУкажите краткое описание задачи.
СерверДаУкажите запись, содержащую информацию о настроенном ранее сервере инфраструктуры в таблице Серверы MID.
СкриптДаУкажите запись, содержащую скрипт инфраструктуры, настроенный ранее, в таблице Скрипты MID.
СтатусДаСтатус задачи. Это поле заполняется автоматически. Доступные варианты:
  • Создана – задача была только что создана, но еще не обработана.
  • В процессе – задача обрабатывается, и код ошибки не возвращен.
  • Завершена – задача была выполнена успешно, и был возвращен код ошибки 0.
  • Ошибка – задача завершена с ошибками, и возвращается любой другой код ошибки.
Обработано вНетДата и время обработки запроса.