История страницы
...
Требования к Оркестратору
- Оркестратор должен быть настроен и запущен в вашей локальной сети, должна быть обеспечена его сетевая доступность для рабочих станций. Уточните адрес (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). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.
...
а. Зайти в панель администратора в 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".
Требования к окружению для установки
Требования к Оркестратору
- Оркестратор должен быть настроен и запущен в вашей локальной сети, должна быть обеспечена его сетевая доступность для рабочих станций. Уточните адрес (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). Для этого откройте в Менеджера файлов директорию с архивом, запустите из него Терминал и выполните команды.
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 <адрес хоста>
Если вам был предоставлен только адрес хоста или только файл конфигурации, укажите их в качестве аргумента при вызове сценария установки (тип параметра распознается автоматически).
Следите за сообщениями на экране. Процесс установки может занять несколько минут.
...
а. Зайти в панель администратора в Keycloak (по адресу https://serverhost:8443/, указать указать свой адрес вместо serverhost)
Логин/пароль по умолчанию: admin/Qwerty123
b. В выпадающем меню выбрать realm "Robin"
...
Пример полученной записи: BDsArvgg7R9lKXJHe6fSKU4dRB8xBlY4
Добавление текущего пользователя в группу rpa-robin
По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:
...
Минимизируйте окно терминала, не закрывая процесс
Настройка рабочей станции на Оркестраторе
Откройте Web-интерфейс Оркестратора
В случае, если ваша учетная запись не зарегистрирована на Оркестраторе, зарегистрируйте ее. Имя учетной записи на Оркестраторе должно совпадать с именем учетной записи на Astra Linux. При регистрации укажите (как минимум) следующие роли: "Исполнитель задач", "Пользователь Robin Player".
Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.
Проверьте наличие хоста в списке оркестратора:
Если имя рабочей станции в списке отсутствует - добавьте его, при этом в выпадающем списке учетных записей выбрать Вашу текущую учетную запись на рабочей станции.
Проверить соединение хоста и оркестратора можно после нажатия на кликабельное имя хоста, откроется форма с информацией, при этом индикатор состояния под именем хоста должен быть зеленым (Online):
Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.
Запуск роботов
Локальный запуск роботов (файл робота на рабочей станции)
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.
Робот может быть запущен 2 способами:
Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player"; либо по двойному клику мышкой на пиктограмме файла
В терминале: 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/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
Окно с инверсией цвета (черный фон):
gui-robin --dark
Деинсталляция
В случае необходимости деинсталяции Платформы Робин, можно воcпользоваться штатными командами операционной системы (apt)
Удаление (деинсталляция)
sudo apt remove -y rpa-robin-core
Добавление рабочей станции возможно после установки и запуска Robin Robot на рабочей станции.
...
Для более подробной информации о работе с Оркестратором обратитесь к документации на Оркестратор.
Запуск роботов
Локальный запуск роботов (файл робота на рабочей станции)
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.
Робот может быть запущен 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)
...
Обзор
Инструменты контента