Установка

Установка серверной части

СОПКА.Рой разворачивается в локальной инфраструктуре заказчика или в выделенном контуре, согласованном договором. Серверная часть поставляется как единый прикладной сервер с собственной базой данных, очередями оперативного обмена и веб-интерфейсом администратора.

1. Подготовьте сервер или виртуальную машину согласно системным требованиям.
2. Создайте и заполните .env: адрес публикации, секреты, параметры БД, Redis, хранения и политики обновлений.
3. Проверьте итоговую конфигурацию и запустите контейнерный стек.
4. Убедитесь, что веб-интерфейс открывается по согласованному адресу /roy.
5. Создайте рабочую область, пользователей и роли доступа.

cd copka_roy_server
docker compose config
docker compose up -d
docker compose ps

Публикация в сети заказчика

В типовом варианте приложение доступно через reverse proxy по HTTPS, а контейнер приложения слушает только локальный интерфейс сервера. PostgreSQL и Redis не публикуются наружу. Внешний доступ к системе, если он требуется, настраивается отдельно в рамках договора и политики безопасности заказчика.

Путь /roy должен передаваться на приложение без удаления префикса. Для прямого экрана, оперативных команд и обновления статусов необходимо разрешить WebSocket upgrade.

Проверка локального контура

Служебные endpoints /roy/api/health/live и /roy/api/health/ready предназначены для локальной проверки контейнера, reverse proxy и внутреннего мониторинга. Их не следует публиковать как внешний публичный API. Проверка выполняется из локальной сети или с самого сервера.

Установка агента

После запуска серверной части администратор создаёт регистрационный ключ в разделе «Настройки - Установка агента», скачивает готовый пакет Windows-агента и запускает установку на рабочей станции. Рабочая область определяется сервером по регистрационному ключу; название рабочей области и её UUID не требуется вручную прописывать на клиенте.

Подробная процедура приведена в документе «Установка агента».