Инструкция по установке программного обеспечения «Единое Решение»

Настоящий документ содержит информацию, необходимую для установки и первичного запуска программного обеспечения «Единое Решение».

Если вы используете «Единое Решение» как интернет-сервис, специальные действия по установке не требуются. Доступ к платформе предоставляется через веб-браузер после заключения договора. Данный раздел предназначен для клиентов, разворачивающих платформу в собственной инфраструктуре.

1. Системные требования

1.1. Требования к программной среде

Компонент	Требование
Операционная система	Astra Linux Special Edition 1.7, РЕД ОС 7.3, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS
Python	Версия 3.12 и выше
Docker	Версия 26.x – 28.x (версия 29 не поддерживается)
Docker Compose	Версия 2.26.1 и выше
Пакетный менеджер	apt-get

1.2. Требования к аппаратному обеспечению

Параметр	Базовая конфигурация	С модулем Copilot (ИИ)
CPU	4 ядра	4–6 ядер
Оперативная память (ОЗУ)	8 ГБ	10 ГБ
Дисковое пространство	100 ГБ	100 ГБ

2. Поддерживаемые типы развёртывания

В платформе поддерживаются три типа развёртывания. В любой момент должен быть активирован ровно один тип.

Тип	Описание
localhost	Локальное развёртывание для разработки, тестирования и эксплуатации во внутренней сети. Требует самостоятельной настройки файрвола и внешнего веб-сервера.
internet	Развёртывание с доступом в интернет для облачной или гибридной эксплуатации по принципу «из коробки».
onpremise	Эксплуатация в закрытом контуре без прямого доступа в интернет. Требует подготовки сертификатов, прокси и локальной DNS-инфраструктуры. Обновления выполняются только по фиксированным тегам релизов.

3. Порядок установки

Шаг 1. Установка системных зависимостей

Выполнить обновление пакетов и установку вспомогательных утилит:

apt update -y
apt install -y jq python3-pip unzip apt-transport-https \
  ca-certificates curl gnupg lsb-release git

Шаг 2. Установка Docker

Добавить репозиторий Docker и выполнить установку. Использовать строго версию 26–28 (версия 29 не поддерживается):

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
  sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

export DOCKER_VERSION="5:28.5.2-1~ubuntu.24.04~noble"
export DOCKER_COMPOSE_PLUGIN_VERSION="2.40.3-1~ubuntu.24.04~noble"

apt-get install -y \
  docker-ce=${DOCKER_VERSION} \
  docker-ce-cli=${DOCKER_VERSION} \
  containerd.io \
  docker-compose-plugin=${DOCKER_COMPOSE_PLUGIN_VERSION}

# Зафиксировать версию — не обновлять автоматически
apt-mark hold docker-ce docker-ce-cli containerd.io docker-compose-plugin

Шаг 3. Установка Python-зависимостей

Рекомендуемый способ:

python3 -m pip install -r scripts/requirements.txt

Альтернативно — через системный пакетный менеджер:

sudo apt-get install -y \
  python3-jinja2 python3-toml python3-packaging \
  python3-cryptography python3-bcrypt
python3 scripts/check_requirements.py --prefer-os

Шаг 4. Клонирование репозитория

Для клонирования необходим GitLab-токен с правами read_repository. Токен предоставляется при заключении договора на поставку ПО.

export GITLAB_TOKEN=ваш_токен

git clone https://solution.gitlab.yandexcloud.net/solutionai/solution-compose.git
cd solution-compose/

python3 -m venv venv
python3 -m pip install -r scripts/requirements.txt

Шаг 5. Первичная установка

Запустить основной скрипт установки. Он автоматически проверяет зависимости, генерирует конфигурационные файлы из шаблонов и подготавливает окружение:

python3 setup-solution.py

Важно: конфигурационные файлы не подлежат локальному изменению. Все изменения вносятся исключительно через репозиторий.

Шаг 6. Запуск платформы

python3 start-solution.py

Скрипт выполняет предварительные проверки корректности конфигурации перед запуском всех микросервисов.

Шаг 7. Проверка работы

После запуска открыть браузер и перейти по адресу сервера. Веб-интерфейс платформы должен быть доступен и отображаться на русском языке.

# Проверить состояние контейнеров
docker compose ps

# Просмотреть логи
docker compose logs --tail=50

4. Обновление платформы

git pull
python3 setup-solution.py
python3 start-solution.py

Для on-premise развёртывания обновление выполняется только по фиксированным тегам релизов. Использование тега latest не допускается.

5. Остановка платформы

python3 stop-solution.py

6. Контакт технической поддержки

По вопросам установки и настройки обращайтесь: support@single-solution.ru