Gramax Enterprise Server

Gramax Enterprise Server (Энтерпрайз, GES) — серверная редакция Gramax. Между приложением и Git-хранилищем появляется сервер GES: через него проходят вход, права доступа и настройки пространства.

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

Возможности

  • Вход через корпоративный SSO. Редакторы при входе в приложение получают все настройки пространства. Читатели на портале документации видят только доступные им каталоги.

  • Расширенное управление доступами. Права на редактирование и просмотр каталогов можно ограничивать и в приложении, и на портале документации.

  • Проверки по стайлгайду компании. Редакторы проверяют тексты на соответствие правилам прямо в интерфейсе, а владелец пространства управляет правилами.

Архитектура

Читатели открывают портал документации в браузере, редакторы работают в приложении или в браузерной версии. Все запросы принимает Caddy и по домену и пути передает нужному сервису. Портал берет каталоги из GitLab, а вход, права и настройки пространства получает у сервера enterprise.

ИИ-сервис и Qdrant запускаются, только если включены ИИ-функции. Подробнее о сервисах и доменах — в статье Установка с помощью Docker Compose.

Порядок работы

  1. Подготовьте инфраструктуру и данные для установки.

  2. Установите GES с помощью Docker Compose на одном сервере или с помощью Helm в кластере Kubernetes.

  3. Подключите SSO — без него в GES никто не войдет.

  4. Выполните первый запуск и проверьте, что сервисы работают.

  5. Настройте нужные функции: базу данных, ИИ, логирование.

  6. Настройте обслуживание: обновление, резервное копирование и мониторинг.

Настройки портала документации, общие для всех способов установки, — в разделе Портал документации.