Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

Версия 1 Следующий »

Требования к окружению для установки

Требования к Оркестратору

  1. Оркестратор должен быть настроен и запущен в вашей локальной сети, должна быть обеспечена его сетевая доступность для рабочих станций. Уточните адрес (URL) Оркестратора у вашего системного администратора.
  2. Версия 2.5.0
  3. Наличие сертификата, заверенного ЦС, включенного в доверенные сертификаты на рабочих станциях. Самоподписанные сертификаты могут использоваться только для пробных запусков и не гарантируют надежной работы

Требования к рабочей станции

  1. RAM не менее 4Gb, свободное место на диске от 5 Gb

  2. Astra Linux 1.7.2 / 64, с базовыми настройками профилей безопасности (без ввода в домен Windows)

  3. Учетная запись с правами администратора (sudo). Внимание. Прямая установка в сеансе root (когда в терминале отображается подсказка root@<host>) может привести к непредсказуемым последствиям и потому недопустима. Проводите установку в сеансе пользователя, у которого доступно выполнение команд через sudo.

  4. Устойчивое подключение к официальным репозиториям Astra Linux (доступ в интернет либо к локальным зеркалам репозиториев пакетов Astra Linux)

  5. Для работы с автоматизацией браузера - необходимо убедиться в наличии одного из браузеров, при необходимости - установить один из поддерживаемых в текущем релизе:

    • Yandex-Browser 22.9

    • Yandex-Browser 22.5

    • Yandex-Browser 22.7

    • Yandex-Browser 23.3

    • Chromium 94

    • Chromium 101

    • Firefox 31

    • Firefox 30

Примечание. Если в комплекте поставки присутствуют роботы, разработанные по заказу, то для работы этих роботов может потребоваться определенная версия браузера (в этом случае необходимо проконсультироваться с разработчиком роботов).

Процесс установки

Необходимые материалы и информация:

  1. Архив с пакетами дистрибутива в формате *.tar.gz
  2. Файл конфигурации Агента с настройками - Robin.Agent.cfg (необязательно, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
  3. Значение ключа ClientSecret для соединения с Оркестратором если он отличается от значения в Robin.Agent.cfg либо этот файл не предоставлен (эти данные необязательны, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
  4. Адрес хоста Оркестратора Робин, установленного в вашей корпоративной сети (можно уточнить у администратора Оркестратора Робин). Адрес хоста должен быть в полном формате со схемой (http/https) и портом, если он отличается от стандартных для схемы значений (http - 80, https - 443). Пример правильного значения: https://orc.robin.corp:9443

Распакуйте полученный архив с файлами дистрибутива в новую директорию внутри вашей домашней директории (например, ~/dist). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.

mkdir -p ~/dist

tar -xvzf <имя архива> -C ~/dist

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

cd ~/dist

Рекомендуется использовать сценарий автоматической установки и конфигурации.

Примечание. При наборе команд и имен в терминале можно использовать клавишу Tab, которая завершает имя после набора первых трех символов, если иных совпадений нет.

Установка

В директории, вместе с установочными пакетами, должны присутствовать следующие файлы:

rpa-robin-install-deb-std.sh

rpa-robin-check-user-group.sh

Для установки выполните команду

sudo ./rpa-robin-install-deb-ent.sh ./Robin.Agent.cfg <адрес хоста> 

Если вам был предоставлен только адрес хоста или только файл конфигурации, укажите их в качестве аргумента при вызове сценария установки (тип параметра распознается автоматически).

Следите за сообщениями на экране. Процесс установки может занять несколько минут.

В ходе установки у Вас будет запрошен ключ ClientSecret. Введи его значение, если он Вам известен, либо сразу нажмите клавишу "Ввод" для продолжения установки без нового ключа.

Получение ClientSecret для аутентификации Robin.Agent через Keycloak

а. Зайти в панель администратора в Keycloak (по адресу https://serverhost:8443/, указать указать свой адрес вместо serverhost)
Логин/пароль по умолчанию: admin/Qwerty123


b. В выпадающем меню выбрать realm "Robin"

c. Получить Secret для агента

Выбрать Clients → Robin.Agent → Credentials → Client secret




Пример полученной записи: BDsArvgg7R9lKXJHe6fSKU4dRB8xBlY4

 Добавление текущего пользователя в группу rpa-robin

По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:

./rpa-robin-check-user-group.sh

Если пользователь не присутствует в группе - вы можете сделать это с помощью команды:

sudo usermod -aG rpa-robin $USER

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

Без участия в группе rpa-robin, пользователь не сможет выполнять роботов.

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

Выполнить команду для первоначальной настройки драйверов для web-браузеров (выполняется однократно для пользователя):

cli-robin webdrivers-bootstrap

Если в системе уже существует файл конфигурации, высветится подтверждение о перезаписи. Рекомендуется перезаписать файл после инсталляции платформы.


Для начала работы выполните в терминале команду:

rpa-connector

Минимизируйте окно терминала, не закрывая процесс

Настройка рабочей станции на Оркестраторе

Откройте Web-интерфейс Оркестратора

В случае, если ваша учетная запись не зарегистрирована на Оркестраторе, зарегистрируйте ее. Имя учетной записи на Оркестраторе должно совпадать с именем учетной записи на Astra Linux. При регистрации укажите (как минимум) следующие роли: "Исполнитель задач", "Пользователь Robin Player".

Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.

Проверьте наличие хоста в списке оркестратора:

Если имя рабочей станции в списке отсутствует - добавьте его,  при этом в выпадающем списке учетных записей выбрать Вашу текущую учетную запись на рабочей станции.


Проверить соединение хоста и оркестратора можно после нажатия на кликабельное имя хоста, откроется форма с информацией, при этом индикатор состояния под именем хоста должен быть зеленым (Online):

Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.

Запуск роботов

Локальный запуск роботов (файл робота на рабочей станции)

Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.

Робот может быть запущен 2 способами:

  1. Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла

  2. В терминале: robinplayer <путь к файлу либо имя файла если в текущей директории>


При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра, закрыть его можно через сочетание клавиш Ctrl+C

Примечание. Запуск робота из робота может не работать из домашней директории пользователя, - в этом случае для них понадобится явная установка группы-владельца rpa-robin и прав на чтение участниками группы rpa-robin.

Удаленный запуск роботов (файл робота на Оркестраторе)

Обратитесь к документации на Оркестратор


Работа в многопользовательском окружении

Если в системе работает несколько различных пользователей, и запускают одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.

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

Команда очистки:

rm -f /tmp/*.robin*

Изменение ключа ClientSecret

Если в ходе эксплуатации Вам понадобится обновить ключ, вы можете сделать это в терминале, введя команду:

cli-robin setup-secret

Ввод значения маскируется, значение ключа не будет отображаться на экране

Изменение пароля RabbitMQ

Если в ходе эксплуатации Вам понадобится изменить пароль для соединения с RabbitMQ, вы можете сделать это в терминале, введя команду:

sudo /usr/local/bin cli-robin config-update Agent Admin -k RabbitPassword -v  <значение пароля>

Обновление драйверов браузера

В случае необходимости обновления драйверов браузера, можно самостоятельно скачать необходимую версию драйвера (с ресурса разработчика драйвера либо браузера). Структура каталогов с драйверами внутри установленной платформы Робин внутри директории /opt/RobinPlatform/2.0.0/drivers/browser имеет следующую структуру (директория с названием браузера, затем директория с именем и версией драйвера, внутри которой находится сам драйвер):

      

  1. Создать директорию /opt/RobinPlatform/2.0.0/Utils/WebDrivers и файл pack.properties в ней.
  2. Скачать драйвер, распаковать если он заархивирован, поместить в директорию, названную в формате "имя-версия".
  3. Убедиться, что он является исполняемым файлом для всех:
    chmod +x yandexdriver
  4. Скопировать директорию с драйвером по нужному пути, например:
    sudo  cp  -a  yandexdriver-23.3.1.755   /opt/RobinPlatform/2.0.0/drivers/browser/yandex/
  5. Добавить запись в файл конфигурации ~/.robin/env.cfg по подобию существующих записей в файле (обратите внимание что для версии Yandex в левой части строк указываются только три цифры без точки - например 229 вместо 22.9.1.1110):


Консоль просмотра журнала роботов

Добавлен инструмент для просмотра журналов. На инструментальном стержне вверху окна можно переключиться на вкладки журналов Агента, действий на Java и действий на Python. В таблицу выводится до 1000 последних записей журнала. После запуска робота для загрузки новых записей можно нажать кнопку Update/Обновить.

Запуск инструмента - из командной строки в сеансе обычного пользователя:

gui-robin

Окно с инверсией цвета (черный фон):

gui-robin --dark

Деинсталляция

В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (apt)

Удаление (деинсталляция)

sudo apt remove -y rpa-robin-core





  • Нет меток