Установка и эксплуатация

Документ содержит сведения, необходимые для установки и эксплуатации программы «Парсвайс» в инфраструктуре заказчика: состав поставки, требования к среде, настройку, порядок установки и эксплуатации.

1. Комплект поставки

Перед применением манифестов заказчик заменяет в них адреса образов на версии из реестра поставки и доменные имена на свои, а также удаляет параметры сервисов, которые не использует: приём платежей через Robokassa, Яндекс Метрику. Манифесты маркетингового сайта, документации и мониторинга в поставку не входят.

Образы передаются архивом OCI для загрузки в реестр заказчика либо через реестр образов правообладателя.

Образы собираются из зеркал правообладателя: базовые образы, пакеты Python и пакеты npm при сборке не загружаются из публичных репозиториев. Для обработки аудио и видео в образ сервера входит ffmpeg из дистрибутива Debian. Модель векторизации при установке и запуске не загружается. Процессы в контейнерах сервера и панели управления работают от непривилегированного пользователя.

2. Требования к среде

Каждый под сервера и обработчика очередей открывает до 40 подключений к PostgreSQL. При большом числе реплик рекомендуется пул соединений, например PgBouncer или Odyssey.

Вычислительные ресурсы

Сумма запросов ресурсов без системных компонентов Kubernetes: около 5,8 vCPU и 14,9 ГиБ памяти при минимальном числе реплик, около 21,1 vCPU и 47,6 ГиБ при максимальном. Узел должен вмещать под векторизации с запросом памяти 2,5 ГиБ.

Конфигурация, на которой программа эксплуатируется правообладателем: 4–10 узлов по 4 vCPU и 8 ГиБ с автоматическим добавлением узлов; основная и векторная базы — отдельные кластеры PostgreSQL 15 по 2 vCPU и 8 ГиБ с диском 20 ГиБ и автоматическим увеличением до 64 ГиБ; Valkey 7.2 — 2 vCPU и 4 ГиБ.

3. Настройка

Параметры сервера, обработчика очередей и планировщика задаются переменными окружения из секретов Kubernetes. Все три развёртывания получают одинаковые параметры подключения к базам, Redis и объектному хранилищу.

Обязательные

Параметры FRONTEND_URL, EMAIL_FROM, SHOPS_DOMAIN и INGRESS_LB_IP имеют значения по умолчанию, указывающие на облачную установку правообладателя, поэтому в установке заказчика их необходимо задать.

Языковая модель

Векторизация

Необязательные

Панель управления и виджет

Панель управления читает параметры установки из переменных окружения контейнера при запуске. Незаданная переменная оставляет значение, с которым собран образ; переменная с пустым значением отключает соответствующую функцию.

Виджет получает адрес сервера программного интерфейса параметром apiUrl в window.ParsewiseConfig на странице, вместе с идентификатором проекта shopId; ссылку на политику обработки персональных данных — параметром privacyPolicyUrl или из настроек проекта.

Одна и та же сборка панели управления и виджета работает в любой установке: пересобирать их под адрес и параметры заказчика не нужно.

4. Установка

1. Подготовить PostgreSQL: основную и векторную базы. В векторной базе должен быть доступен тип vector. Если его нет, программа выполняет CREATE EXTENSION IF NOT EXISTS vector; если у роли приложения нет такого права, администратор базы выполняет CREATE EXTENSION vector заранее.
2. Подготовить Redis и бакет S3-совместимого объектного хранилища.
3. Загрузить образы в реестр, доступный кластеру, и указать их адреса в манифестах.
4. Создать пространство имён и секреты с параметрами из раздела 3.
5. Указать в манифесте маршрутизации доменные имена программного интерфейса и панели управления, настроить TLS.
6. Применить манифесты. При запуске сервер создаёт недостающие таблицы основной базы и применяет миграции, входящие в образ; векторное хранилище создаёт свои таблицы и индексы.
7. Разместить файлы виджета на статическом сервере или в объектном хранилище заказчика.
8. Проверить установку:
   • все поды в состоянии готовности; поды векторизации загружают модель до трёх минут;
   • запрос GET /v1/public/health к серверу программного интерфейса возвращает {"status": "ok"};
   • в журнале сервера есть строка Alembic migrations applied (head reached) и нет сообщений Alembic upgrade failed и ошибок pgvector.

5. Начало работы

1. Войти в панель управления и создать проект.
2. Настроить персону ассистента: имя, аватар и правила ответов.
3. Наполнить базу знаний: загрузить файлы, импортировать товары или профили из файла либо подключить источник по ссылке.
4. Пригласить участников команды и назначить роли.
5. Подключить виджет на страницы сайта или личного кабинета:

<script>
  window.ParsewiseConfig = {
    shopId: "ИДЕНТИФИКАТОР_ПРОЕКТА",
    apiUrl: "https://АДРЕС_СЕРВЕРА_API",
  };
</script>
<script async src="https://АДРЕС_СТАТИКИ/widget.iife.js"></script>

Подробный порядок работы в панели управления — в Руководстве пользователя и администратора.

6. Эксплуатация