Установка Semantix в контуре: обзор
Требования, состав компонентов, выбор между Docker Compose и Kubernetes, место для GPU-сервера с моделью и где взять полную инструкцию по установке.
Semantix устанавливается в периметре заказчика: на одном сервере или в кластере Kubernetes. Эта статья даёт общую картину. Пошаговая процедура с командами, проверками и регламентами содержится в Инструкции по установке ПО (76 страниц), а интерактивный выбор варианта в мастере Развернуть Semantix в контуре.
Требования
Минимальные ресурсы для установки на одном сервере:
| Ресурс | Минимум | Для эксплуатации |
|---|---|---|
| Процессор | 4 ядра | от 8 ядер, больше при параллельной обработке документов |
| Память | 16 Гбайт | от 32 Гбайт, зависит от средств распознавания и моделей |
| Диск | 50 Гбайт | от 200 Гбайт на отдельном надёжном томе |
| ОС | 64-разрядный Linux x86-64 | поддерживаются Astra Linux Special Edition 1.7 и 1.8, РЕД ОС 7.3 и 8.0 |
Дополнительно: Docker с поддержкой docker compose, системный параметр vm.max_map_count не ниже 262144, свободные порты 80 и 443, доменное имя и сертификат от доверенного удостоверяющего центра, синхронизация времени. Для кластера минимальные значения не применяются: ресурсы рассчитываются отдельно для прикладных служб и каждого хранилища по числу пользователей, объёму документов и очереди обработки.
Состав компонентов
| Компонент | Назначение | Постоянные данные |
|---|---|---|
| Серверная часть (backend) | Экранные формы, API, прикладные операции | Настройки и связи объектов в PostgreSQL |
| Обработчик заданий | Извлечение текста, фрагментация, фоновые задания | Состояние заданий в PostgreSQL и временном хранилище |
| Веб-интерфейс и входная служба | Публикация интерфейса и API по HTTPS | Сертификаты, пользовательских данных не хранит |
| PostgreSQL | Учётные записи, организации, настройки, состояние заданий | Критичные данные, обязательны для копирования |
| Объектное хранилище MinIO или S3 | Исходные документы и производные файлы | Критичные пользовательские файлы |
| Временное хранилище Valkey (Redis-совместимое) | Очереди, сеансы, короткоживущее состояние | Не заменяет резервную копию |
| Хранилище документов | Поисковые представления и индексы | Infinity по умолчанию, допускаются Elasticsearch и OpenSearch |
| Служба учётных записей | Вход, SSO, роли | Данные службы входят в резервную копию |
| Служба моделей | Генерация, эмбеддинги, реранкер | Внешняя служба или отдельная нагрузка с GPU; в стандартный комплект не входит |
Увеличение числа экземпляров серверной части не устраняет единичную точку отказа в базе данных или хранилище. Для промышленной среды каждому хранилищу нужна либо внешняя отказоустойчивая служба, либо утверждённая многосоставная схема, либо явно принятое время восстановления из копии.
Docker Compose или Kubernetes
Один сервер, Docker Compose. Комплект содержит каталог docker/ с файлами docker-compose.yml, docker-compose-base.yml, .env, шаблоном настроек и сценариями запуска и переноса. Подходит для пилота, небольшой организации и тестовой среды. Все хранилища работают в одном экземпляре.
Кластер Kubernetes или Deckhouse Kubernetes Platform. Кластерный пакет содержит Helm-чарт и файл значений values-production.yaml: число экземпляров backend и обработчиков, классы и размеры постоянных томов, ingress и TLS, настройки службы учётных записей, срок хранения журнала аудита, том для кэша моделей. Выбирайте кластер, если нужны несколько экземпляров прикладных служб, распределение по узлам и штатные средства наблюдения и резервного копирования платформы.
Порядок установки одинаков для любого варианта после подготовки ОС: проверить контрольные суммы комплекта, заменить все демонстрационные пароли, задать адреса моделей и внешний адрес, запустить службы, выполнить первый вход главного администратора, создать организацию, подключить модели, загрузить контрольный документ и выполнить контрольный поиск.
Внимание
Порты базы данных, поискового, объектного и временного хранилищ не публикуются во внешние сети. Из пользовательской сети доступен только входной адрес по HTTPS. Секреты не хранятся в файлах состава контейнеров и системе контроля версий.
Модель: своя GPU или внешний API
Если платформа обращается к внешней службе моделей (через шлюз, с белым списком провайдеров и правилами передачи данных), графические ускорители на узлах Semantix не требуются. Если модель размещается в контуре, она проектируется как отдельная нагрузка: узлы с GPU, драйверы, постоянный кэш моделей, расчёт памяти устройств. Платформа работает с vLLM и другими OpenAI-совместимыми серверами, а также с Ollama, Xinference, LocalAI и аналогами. Модель подключается в разделе «Провайдеры моделей» с указанием базового адреса, имени модели и предельного размера контекста. Модель эмбеддингов после создания фрагментов не меняется без повторной обработки баз знаний.
Изолированная среда
Для контура без доступа в интернет заранее переносятся образы с контрольными суммами, пакеты ОС, файлы моделей и словари распознавания. Перед включением строгого автономного режима проверяется обработка контрольного документа при полностью отключённом внешнем доступе.
После установки
Обязательные проверки: страница входа открывается на русском языке, сертификат действителен, главному администратору доступна «Консоль администратора», организация создаётся, документ обрабатывается до состояния «УСПЕШНО», контрольный поиск возвращает ожидаемый фрагмент, в журнале отражается событие входа, данные сохраняются после перезапуска. Дальше настраиваются резервное копирование (полная копия еженедельно, изменения ежедневно, пробное восстановление ежеквартально) и оповещения по месту, памяти, перезапускам и сроку сертификата.
Дальше: Организации, роли и доступ, Подключение 1С через OData, все руководства в разделе Документы.
Спросить Сему