Документация 0.4

Установка

Все файлы версии — на странице Скачать: у каждого указаны размер и SHA-256. Интернет на сервере и компьютерах роботов для установки и работы не нужен: файлы можно перенести на флешке.

Файл Что это Куда ставится
Tulpar-0.4.0-win-x64.zip Студия и робот, примеры процессов Компьютер разработчика процессов
TulparAgent-0.4.0-win-x64.zip Агент и робот Каждый компьютер-робот
TulparOrchestrator-0.4.0-win-x64.zip Сервер оркестратора с панелью, скрипты установки и обновления Windows Server
TulparOrchestrator-0.4.0-docker.zip docker-compose.yml и скрипты Linux с Docker
tulpar-orchestrator-0.4.0.tar, postgres-18.tar Образы Docker для сервера без интернета Linux с Docker

Требования #

Что Требования
Студия Windows 10 21H2+ или 11, x64, WebView2 Runtime (есть в Windows 10 и 11)
Робот и агент Windows 10 21H2+ / 11 / Windows Server 2019+ с рабочим столом, 64-бит
Сервер оркестратора Windows Server 2019 / 2022 / 2025 или Linux x64 с Docker 24+ (Ubuntu 22.04/24.04, Debian 12, Astra Linux, РЕД ОС); минимум 2 vCPU и 4 ГБ памяти, рекомендуется 4 vCPU, 8 ГБ, SSD 200 ГБ
База данных PostgreSQL 16–18 в кодировке UTF-8 (поставляется и проверяется 18)
Браузер для действий „Браузер“ Microsoft Edge (есть в Windows) или Google Chrome на компьютере робота
Сеть Роботы и браузеры подключаются к серверу по HTTPS на порт 8443; на роботах порты открывать не нужно

Студия и робот работают и без оркестратора: процессы запускаются прямо из студии или командой tulpar-robot run. Оркестратор нужен, чтобы роботы работали по расписанию, по очередям и под присмотром.

Студия #

  1. Распакуйте Tulpar-0.4.0-win-x64.zip в любую папку, например C:\Tulpar\Studio. Права администратора не нужны.
  2. Запустите Tulpar.Studio.exe. Если на компьютере нет WebView2 Runtime, студия скажет об этом и даст ссылку на установщик.
  3. Откройте пример: «Открыть» → samples\flows\01_hello.flow.json из папки студии, нажмите «Запуск» (F5).

Дальше — Первый процесс. Настройки студии хранятся в %APPDATA%\Tulpar\settings.json, журналы — в %LOCALAPPDATA%\Tulpar\logs. В той же папке, что и студия, лежит tulpar-robot.exe — робот, который выполняет процессы из командной строки:

.\tulpar-robot.exe run samples\flows\01_hello.flow.json --arg greeting="Салам!"
.\tulpar-robot.exe validate samples\flows\01_hello.flow.json

Агент робота #

Агент ставится на каждый компьютер, где будет работать робот: он держит связь с оркестратором, получает задания и запускает робота. Порты на компьютере робота не открываются — агент подключается к серверу сам.

  1. В панели оркестратора: «Роботы» → «Подключить робота» — имя, режим, теги, рабочие области; скопируйте строку подключения (одноразовая, действует 24 часа). Архив агента можно скачать там же — его раздаёт сам сервер.
  2. На компьютере робота распакуйте TulparAgent-0.4.0-win-x64.zip, запустите Tulpar.Agent.exe, вставьте строку и подключитесь — робот появится в панели через несколько секунд.
Режим робота Как ставится
С участием человека (компьютер сотрудника) В окне агента — установить для этого пользователя: агент запускается при входе в Windows, права администратора не нужны. Сотрудник запускает процессы из трея
Фоновый (выделенная машина) От администратора: Tulpar.Agent.exe install --mode unattended --user КОМПАНИЯ\robot02 --autologon --connect "tulpar://connect?…" — агент работает под учётной записью робота, Windows входит в неё сам

Подробности — проверка робота, обслуживание, сеанс RDP, обновление агентов — в руководстве администратора.

Оркестратор на Windows Server #

  1. Установите PostgreSQL 18 (установщик EDB: компоненты сервер и Command Line Tools) и запишите пароль пользователя postgres.

  2. Распакуйте TulparOrchestrator-0.4.0-win-x64.zip и в PowerShell от администратора посмотрите план установки, затем установите:

    Set-ExecutionPolicy -Scope Process Bypass
    .\install-server.ps1 -PublicUrl https://orch.company.kg:8443 -WhatIf
    .\install-server.ps1 -PublicUrl https://orch.company.kg:8443
    

    Скрипт создаст базы tulpar и tulpar_reports, службу TulparOrchestrator, откроет порт 8443 и покажет адрес панели и токен установки.

  3. Откройте панель https://orch.company.kg:8443, введите токен установки и пройдите мастер первого запуска: организация, часовой пояс, администратор.

  4. Сразу сохраните ключ шифрования (Tulpar.Orchestrator.exe keys export --out <файл>) и настройте резервные копии.

Установка занимает около 15 минут. Пошагово, с параметрами скрипта, сертификатом и резервным копированием — в руководстве администратора.

Оркестратор в Docker #

cd /opt/tulpar                      # распакованный TulparOrchestrator-0.4.0-docker.zip
docker load -i tulpar-orchestrator-0.4.0.tar && docker load -i postgres-18.tar   # только без интернета
sudo sh ./init-secrets.sh           # .env со случайным паролем базы и secrets/master.key
nano .env                           # PUBLIC_URL=https://orch.company.kg:8443
docker compose up -d
docker compose exec orchestrator dotnet Tulpar.Orchestrator.dll print-setup-token

Откройте PUBLIC_URL и пройдите мастер. Копию secrets/master.key сохраните вне сервера: без ключа пароли учётных данных из резервной копии не восстановить.

Пробный период и лицензия #

Лицензии Tulpar не требуют активации через интернет: компьютер или сервер выдаёт код запроса, по нему выпускается файл лицензии .tlic, файл загружается обратно. Подробно — в разделе Лицензирование.

Оркестратор #

  1. В панели: «Настройки» → «Лицензия» — блок «Код запроса», «Скопировать код».
  2. Отправьте код владельцу продукта: через личный кабинет на сайте («Получить файл лицензии»), письмом или продиктуйте — код не секретный.
  3. Полученный файл загрузите там же: «Загрузить лицензию». Лицензия начинает действовать сразу, без перезапуска; роботы получают места по дате создания.

Студия #

Студия без подключения к оркестратору работает 30 дней полностью с первого запуска. Потом процессы по-прежнему открываются, редактируются и запускаются на этом компьютере, но публикация недоступна, а в верхней панели — „Пробный период окончен…“. Чтобы продолжить, есть два способа:

  • Место студии в оркестраторе. Подключите студию к оркестратору («Оркестратор» → «Подключение…»), где администратор отметил вам «Студия» в «Пользователи». Подключённая студия работает без связи с сервером 14 дней.
  • Лицензия студии на компьютер — для работы без оркестратора: «Справка» → «Лицензия…», скопируйте «Код запроса», отправьте его владельцу продукта, полученный файл — «Загрузить файл…» и «Ввести лицензию».
«Лицензия Tulpar Studio»: пробный период, код компьютера и код запроса
«Лицензия Tulpar Studio»: пробный период, код компьютера и код запроса