Требования к окружению для установки
RAM не менее 4Gb, свободное место на диске от 5 Gb.
Astra Linux 1.7.2, с базовыми настройками профилей безопасности (без ввода в домен Windows).
Учетная запись с правами администратора (sudo).
Наличие установленного dotnet-sdk-6.0. Инструкция по установке от разработчика ОС Astra Linux: https://wiki.astralinux.ru/pages/viewpage.action?pageId=41192241. Другой способ установки рассмотрен в Приложении 1.
Устойчивое подключение к официальным репозиториям Astra Linux (доступ в интернет либо к локальным зеркалам репозиториев пакетов RED OS).
Для работы с автоматизацией браузера - необходимо убедиться в наличии одного из браузеров, при необходимости - установить один из поддерживаемых в текущем релизе:
Yandex-Browser 22.9
Yandex-Browser 22.5
Yandex-Browser 22.7
Yandex-Browser 23.3
Chromium 94
Chromium 101
Firefox 31
Firefox 30
Процесс установки
В случае, если ранее были установлены компоненты ROBIN Robot, рекомендуется удалить их перед началом установки.
Перед установкой проверяем, что на компьютере уже не установлены пакеты дистрибутивов Robin:
dpkg -l | grep robin
В случае их наличия будет выведен список пакетов, которые необходимо удалить.
Для удаления данных пакетов необходимо выполнить следующую команду:
sudo apt remove -y <имя пакета>
Установка
Скачайте или скопируйте предоставленный архив с пакетами установки и распакуйте в отдельную директорию.
В директории, вместе с установочными пакетами, должны присутствовать следующие файлы:
rpa-robin-install-deb-std.sh
rpa-robin-check-user-group.sh
Если у вас на этом компьютере уже установлена предыдущая версия платформы, рекомендуется ее удалить.
Для установки выполните команду
sudo ./rpa-robin-install-deb-std.sh
Следите за сообщениями на экране.
Установить сервис Агента на постоянную загрузку:
sudo systemctl enable robinagent.service
Запустить сервис:
sudo systemctl restart robinagent.service
Добавление текущего пользователя в группу rpa-robin
По окончанию установки проверьте, не присутствует ли текущий пользователь в группе rpa-robin для работы с роботами. Для этого можно воспользоваться приложенной утилитой:
./rpa-robin-check-user-group.sh
Если пользователь не присутствует в группе - вы можете сделать это с помощью команды:
sudo usermod -aG rpa-robin $USER
Без участия в группе rpa-robin пользователь не сможет выполнять роботов.
Выполнить команду для первоначальной настройки драйверов для web-браузеров (выполняется однократно для пользователя):
cli-robin webdrivers-bootstrap
Если в системе уже существует файл конфигурации, высветится подтверждение о перезаписи. Рекомендуется перезаписать файл после инсталляции платформы.
Запуск роботов
Для успешного выполнения робота необходимо, чтобы версии действий, используемых в роботе, присутствовали в установленной платформе.
Робот может быть запущен 2 способами:
Из файлового менеджера - по клику правой кнопкой - вверху контекстного меню элемент "Открыть в Robin Player" либо по двойному клику мышкой на пиктограмме файла
В терминале: robinplayer <путь к файлу либо имя файла, если он в текущей директории>
При запуске робота откроется терминальное окно с сообщениями о ходе выполнения. После успешного выполнения окно закроется автоматически, в случае критичной ошибки робота - останется открытым для просмотра. Закрыть его можно с помощью сочетания клавиш Ctrl+C.
В случае необходимости деинсталляции Платформы ROBIN, можно воcпользоваться штатными командами операционной системы (apt, apt-get)
Удаление (деинсталляция):
sudo apt remove -y rpa-robinplatform...
(вместо многоточия в конце набора имени нажать Tab - высветится точное имя пакета)
sudo apt remove -y rpa-robin-driver...
(вместо многоточия в конце набора имени нажать Tab - высветится точное имя пакета)
Работа в многопользовательском окружении
Если в системе работает несколько различных пользователей и запускает одних и тех же роботов, могут быть конфликты на уровне временных файлов в общей директории /tmp.
Во избежание конфликтов на компьютерах, в которых работает несколько пользователей, рекомендуется очищать временные файлы в директории /tmp после завершения работы и перед выходом из системы.
Команда очистки:
rm -f /tmp/*.robin*
Обновление драйверов браузера
В случае необходимости обновления драйверов браузера можно самостоятельно скачать необходимую версию драйвера (с ресурса разработчика драйвера либо браузера). Структура каталогов с драйверами внутри установленной платформы ROBIN внутри директории /opt/RobinPlatform/2.0.0/drivers/browser имеет следующую структуру (директория с названием браузера, затем директория с именем и версией драйвера, внутри которой находится сам драйвер):
- Скачать драйвер, распаковать, если он заархивирован, поместить в директорию, названную в формате "имя-версия"
- Убедиться, что он является исполняемым файлом для всех:
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
Приложение 1. Вариант установки .NET
Установка .NET:
sudo apt install -y curl
cd ~
curl -L https://download.visualstudio.microsoft.com/download/pr/e77438f6-865f-45e0-9a52-3e4b04aa609f/024a880ed4bfbfd3b9f222fec0b6aaff/dotnet-runtime-6.0.25-linux-x64.tar.gz -o dotnet-runtime-6.0.25-linux-x64.tar.gz
sudo mkdir -p /opt/vendor/dotnet
sudo tar xzf ./dotnet-runtime-*.tar.gz -C /opt/vendor/dotnet/
sudo ln -sf /opt/vendor/dotnet/dotnet /usr/local/bin/dotnet