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