История страницы
Требования к окружению для установки
Требования к Оркестратору
- Оркестратор должен быть настроен и запущен в вашей локальной сети, должна быть обеспечена его сетевая доступность для рабочих станций. Уточните адрес (URL) Оркестратора у вашего системного администратора.
- Версия 2.5.0
- Наличие сертификата, заверенного ЦС, включенного в доверенные сертификаты на рабочих станциях. Самоподписанные сертификаты могут использоваться только для пробных запусков и не гарантируют надежной работы
Требования к рабочей станции
RAM не менее 4Gb, свободное место на диске от 5 Gb
Astra Linux 1.7.2 / 64, с базовыми настройками профилей безопасности (без ввода в домен Windows)
Учетная запись с правами администратора (sudo). Внимание. Прямая установка в сеансе root (когда в терминале отображается подсказка root@<host>) может привести к непредсказуемым последствиям и потому недопустима. Проводите установку в сеансе пользователя, у которого доступно выполнение команд через sudo.
Устойчивое подключение к официальным репозиториям Astra Linux (доступ в интернет либо к локальным зеркалам репозиториев пакетов Astra Linux)
Для работы с автоматизацией браузера - необходимо убедиться в наличии одного из браузеров, при необходимости - установить один из поддерживаемых в текущем релизе:
Yandex-Browser 22.9
Yandex-Browser 22.5
Yandex-Browser 22.7
Yandex-Browser 23.3
Chromium 94
Chromium 101
Firefox 31
Firefox 30
Примечание. Если в комплекте поставки присутствуют роботы, разработанные по заказу, то для работы этих роботов может потребоваться определенная версия браузера (в этом случае необходимо проконсультироваться с разработчиком роботов).
Процесс установки
Необходимые материалы и информация:
- Архив с пакетами дистрибутива в формате *.tar.gz
- Файл конфигурации Агента с настройками - Robin.Agent.cfg (необязательно, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
- Значение ключа ClientSecret для соединения с Оркестратором если он отличается от значения в Robin.Agent.cfg либо этот файл не предоставлен (эти данные необязательны, но это позволит упростить настройки после установки, можно уточнить у администратора Оркестратора Робин).
- Адрес хоста Оркестратора Робин, установленного в вашей корпоративной сети (можно уточнить у администратора Оркестратора Робин). Адрес хоста должен быть в полном формате со схемой (http/https) и портом, если он отличается от стандартных для схемы значений (http - 80, https - 443). Пример правильного значения: https://orc.robin.corp:9443
Распакуйте полученный архив с файлами дистрибутива в новую директорию внутри вашей домашней директории (например, ~/dist). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.
...
Примечание. При наборе команд и имен в терминале можно использовать клавишу Tab, которая завершает имя после набора первых трех символов, если иных совпадений нет.
Установка
В директории, вместе с установочными пакетами, должны присутствовать следующие файлы:
...
а. Зайти в панель администратора в Keycloak (по адресу https://serverhost:8443/, указать указать свой адрес вместо serverhost)
Логин/пароль по умолчанию: admin/Qwerty123
b. В выпадающем меню выбрать realm "Robin"
c. Получить Secret для агента
Выбрать Clients → Robin.Agent → Credentials → Client secret
Пример полученной записи: BDsArvgg7R9lKXJHe6fSKU4dRB8xBlY4
...
Добавление текущего пользователя в группу rpa-robin
По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:
...
sudo usermod -aG rpa-robin $USER
| Информация |
|---|
| Внимание. Чтобы участие пользователя в группе вступило в силу, рекомендуется перезапустить операционную систему. |
Без участия в группе rpa-robin, пользователь не сможет выполнять роботов.
...
Минимизируйте окно терминала, не закрывая процесс
Настройка рабочей станции на Оркестраторе
Откройте Web-интерфейс Оркестратора
В случае, если ваша учетная запись не зарегистрирована на Оркестраторе, зарегистрируйте ее. Имя учетной записи на Оркестраторе должно совпадать с именем учетной записи на Astra Linux. При регистрации укажите (как минимум) следующие роли: "Исполнитель задач", "Пользователь Robin Player".
Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.
Проверьте наличие хоста в списке оркестратора:
Если имя рабочей станции в списке отсутствует - добавьте его, при этом в выпадающем списке учетных записей выбрать Вашу текущую учетную запись на рабочей станции.
Проверить соединение хоста и оркестратора можно после нажатия на кликабельное имя хоста, откроется форма с информацией, при этом индикатор состояния под именем хоста должен быть зеленым (Online):
Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.
Запуск роботов
Локальный запуск роботов (файл робота на рабочей станции)
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.
Робот может быть запущен 2 способами:
Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла
В терминале: robinplayer <путь к файлу либо имя файла если в текущей директории>
При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра, закрыть его можно через сочетание клавиш Ctrl+C
Примечание. Запуск робота из робота может не работать из домашней директории пользователя, - в этом случае для них понадобится явная установка группы-владельца rpa-robin и прав на чтение участниками группы rpa-robin.
Удаленный запуск роботов (файл робота на Оркестраторе)
Обратитесь к документации на Оркестратор
Работа в многопользовательском окружении
Если в системе работает несколько различных пользователей, и запускают одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.
...
Команда очистки:
rm -f /tmp/*.robin*
Изменение ключа ClientSecret
Если в ходе эксплуатации Вам понадобится обновить ключ, вы можете сделать это в терминале, введя команду:
...
Ввод значения маскируется, значение ключа не будет отображаться на экране
Изменение пароля RabbitMQ
Если в ходе эксплуатации Вам понадобится изменить пароль для соединения с RabbitMQ, вы можете сделать это в терминале, введя команду:
sudo /usr/local/bin/cli-robin config-update Agent Admin -k RabbitPassword -v <значение пароля>
Обновление драйверов браузера
В случае необходимости обновления драйверов браузера, можно самостоятельно скачать необходимую версию драйвера (с ресурса разработчика драйвера либо браузера). Структура каталогов с драйверами внутри установленной платформы Робин внутри директории /opt/RobinPlatform/2.0.0/drivers/browser имеет следующую структуру (директория с названием браузера, затем директория с именем и версией драйвера, внутри которой находится сам драйвер):
- Создать директорию /opt/RobinPlatform/2.0.0/Utils/WebDrivers и файл pack.properties в ней.
- Скачать драйвер, распаковать если он заархивирован, поместить в директорию, названную в формате "имя-версия".
- Убедиться, что он является исполняемым файлом для всех:
chmod +x yandexdriver - Скопировать директорию с драйвером по нужному пути, например:
sudo cp -a yandexdriver-23.3.1.755 /opt/RobinPlatform/2.0.0/drivers/browser/yandex/ - Добавить запись в файл конфигурации ~/.robin/env.cfg по подобию существующих записей в файле (обратите внимание что для версии Yandex в левой части строк указываются только три цифры без точки - например 229 вместо 22.9.1.1110):
Консоль просмотра журнала роботов
Добавлен инструмент для просмотра журналов. На инструментальном стержне вверху окна можно переключиться на вкладки журналов Агента, действий на Java и действий на Python. В таблицу выводится до 1000 последних записей журнала. После запуска робота для загрузки новых записей можно нажать кнопку Update/Обновить.
Запуск инструмента - из командной строки в сеансе обычного пользователя:
...
Окно с инверсией цвета (черный фон):
gui-robin --dark
Деинсталляция
В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (apt)
...
Обзор
Инструменты контента