Типовой сайзинг

Раздел содержит типовой расчёт инфраструктуры для развёртывания Citeck. На этой странице собрано то, что одинаково для всех вариантов развёртывания: целевая нагрузка, итоговые конфигурации, состав и ресурсы контейнеров платформы, правила пересчёта с учётом фактического объёма документооборота и границы применимости. Детальный расчёт нод и виртуальных машин вынесен в подразделы по способу развёртывания.

Примечание

Подразделы

Сайзинг в Kubernetes

Worker-ноды продуктивного кластера и кластера для разработки и тестирования (Test или Dev + Test): типоразмер ноды, количество нод с резервированием N+1, Persistent Volumes и диски вне кластера.

Сайзинг в Kubernetes
Сайзинг на одной ВМ: Citeck Launcher

Конфигурации ВМ для развёртывания с помощью Citeck Launcher 2.x — профили до 100 и до 2000 именных пользователей, разметка дисков, ограничения схемы с одной ВМ.

Сайзинг на одной ВМ: Citeck Launcher
Требования к внешним сервисам

PostgreSQL, S3-совместимое хранилище, OpenSearch и RabbitMQ при выносе за пределы кластера или ВМ: ресурсы, диски, версии, перечень баз данных.

Требования к внешним сервисам

Целевая нагрузка

Параметр

Значение

Число именных пользователей

2000

Число одновременных пользователей в пике

до 500 (соотношение именных к одновременным — 4:1 — принято во всех расчётах раздела)

Подтверждение нагрузочным тестированием

1000 одновременных пользователей в течение 1 часа: ~2 млн запросов, средний отклик 6.88 мс, 99-й перцентиль 47 мс. Подробнее — Результаты нагрузочного тестирования

Профиль работы

типовой документооборот: карточки, маршруты согласования, поиск, работа с вложениями

Базовый объём контента

500 ГБ

Расчёт описывает минимальный объём ресурсов платформы: состав микросервисов задан поставкой Citeck и при уменьшении числа пользователей не сокращается. При 500 именных пользователях и том же объёме документооборота конфигурация остаётся такой же, как при 2000, — меняется только объём логов. Исключение — облегчённый профиль до 100 именных пользователей на одной ВМ: у него меньше ресурсы PostgreSQL и запас на пики (см. Сайзинг на одной ВМ: Citeck Launcher).

Основной фактор, определяющий потребность в ресурсах, — объём документооборота, а не число пользователей: от него зависят объём контента в S3, дисковое пространство и ресурсы PostgreSQL, а также размер поисковых индексов.

Контуры (среды):

  • Prod — продуктив;

  • Test — одна непродуктивная среда для разработки, отладки и приёмочного тестирования;

  • Dev + Test — две раздельные непродуктивные среды в одном кластере: Dev — разработка, Test — отладка и приёмочное тестирование.

Итоговые конфигурации

Сводка по обоим способам развёртывания; детали расчёта — в подразделах.

Одна ВМ на каждую среду. При схеме Dev + Test + Prod к продуктивной ВМ добавляется ещё одна ВМ по конфигурации Test. Подробнее — Сайзинг на одной ВМ: Citeck Launcher.

Профиль и контур

Без полнотекстового поиска

С полнотекстовым поиском (OpenSearch)

Диски

До 100 именных (от минимальной до рекомендуемой конфигурации)

8–16 vCPU / 24–32 GiB

8–16 vCPU / 32–40 GiB

240–500 ГБ SSD

До 2000 именных, Prod

16 vCPU / 48 GiB

24 vCPU / 64 GiB

ОС 100 ГБ + данные ~1.3 ТБ

До 2000 именных, Test

16 vCPU / 48 GiB

16 vCPU / 48 GiB

ОС 100 ГБ + данные ~300 ГБ

Профиль до 2000 именных пользователей. PostgreSQL и OpenSearch выносятся за пределы кластера; S3-хранилище (1 узел) и RabbitMQ остаются внутри кластера и учтены в ресурсах worker-нод. Подробнее — Сайзинг в Kubernetes и Требования к внешним сервисам.

Контур

Worker-ноды

Persistent Volumes в кластере

PostgreSQL (вне кластера)

OpenSearch (вне кластера, при полнотекстовом поиске)

Prod

2 × (16 vCPU / 32 GiB), резерв N+1

~555 ГБ

8 vCPU / 32 GiB / 400 ГБ NVMe

8 vCPU / 32 GiB / 300 ГБ NVMe

Test

1–2 × (16 vCPU / 32 GiB)

~145 ГБ

2 vCPU / 4 GiB / 50–100 ГБ SSD

4 vCPU / 16 GiB / 100 ГБ NVMe

Dev + Test

2–3 × (16 vCPU / 32 GiB)

~145 ГБ на каждую среду

то же на каждую среду

то же на каждую среду

На каждой worker-ноде дополнительно закладывается локальный диск 100 ГБ SSD.

Выбор способа развёртывания

Важно

Вне Kubernetes единственный рекомендуемый способ развёртывания — Citeck Launcher 2.x в серверном режиме. Docker Compose больше не поддерживается: конфигурации Docker Compose для новых версий Citeck выпускаться не будут. Перенос существующей установки под управление лончера — Миграция данных с docker-compose.

Аспект

Одна ВМ (Citeck Launcher 2.x)

Kubernetes

Отказоустойчивость

отсутствует: ВМ — единая точка отказа

резерв N+1 по worker-нодам, перезапуск подов на другой ноде; PostgreSQL и S3-хранилище в базовом расчёте развёрнуты в одном экземпляре

Обновления

с остановкой сервисов

поэтапное обновление (rolling update); при нескольких репликах сервисов — без деградации

Масштабирование

вертикальное — за счёт увеличения ресурсов ВМ. Тиражирование отдельных микросервисов в Citeck Launcher пока не поддерживается: оно появится в будущих версиях, но только в пределах одной ВМ

горизонтальное — за счёт добавления нод и реплик штатными средствами кластера

Кластеризация PostgreSQL, S3, OpenSearch

в рамках одной ВМ не предусмотрена, требует выноса компонентов на отдельные ВМ

обеспечивается выносом компонентов на выделенные ВМ или в managed-сервисы (в расчёт не входит)

Область применения

демо- и тестовые контуры, продуктив без формальных требований к доступности

продуктив с требованиями к доступности (RPO / RTO) и численностью свыше 2000 именных пользователей

Состав и ресурсы контейнеров платформы

Состав контейнеров задан поставкой Citeck и одинаков для всех способов развёртывания и любого числа пользователей.

Группа контейнеров

Requests

Limits

Микросервисы Citeck (13)

6.90 vCPU / 15.46 Gi

15.00 vCPU / 15.46 Gi

Инфраструктурные компоненты (6)

2.70 vCPU / 7.25 Gi

8.00 vCPU / 9.50 Gi

Итого по контейнерам платформы

9.60 vCPU / 22.71 Gi

23.00 vCPU / 24.96 Gi

Сумма limits по CPU — верхняя граница одновременного потребления, на практике она не достигается (см. Методика расчёта).

Ресурсы каждого контейнера

Микросервисы Citeck

Микросервис

Requests CPU, vCPU

Requests MEM, Gi

Limits CPU, vCPU

Limits MEM, Gi

Ecos Model

2

1

2

1

Ecos Gateway

2

1

2

1

Ecos Apps

0.1

1

1

1

Ecos Process

1

3.46 (3548 Mi)

1

3.46 (3548 Mi)

Ecos Uiserv

1

1

1

1

Ecos History

0.1

1

1

1

Ecos Integrations

0.1

1

1

1

Ecos Notifications

0.1

1

1

1

Ecos Transformations

0.1

1

1

1

Ecos Ecom

0.1

1

1

1

Ecos Service Desk

0.1

1

1

1

Ecos Edi

0.1

1

1

1

Ecos Content

0.1

1

1

1

Итого

6.90

15.46

15.00

15.46

Инфраструктурные компоненты

Компонент

Requests CPU, vCPU

Requests MEM, Gi

Limits CPU, vCPU

Limits MEM, Gi

Ecos Proxy

0.3

0.25

1

0.5

Zookeeper

0.5

1

1

1

Ecos Identity (Keycloak)

0.3

1

1

1

Onlyoffice

0.1

2

2

2

RabbitMQ

0.5

1

1

1

S3-хранилище (1 узел) *

1

2

2

4

Итого

2.70

7.25

8.00

9.50

* Значения для S3-хранилища приняты в настоящем расчёте; остальные значения приведены по документации Citeck (Менеджмент ресурсов подов и контейнеров).

См. также

Методика расчёта

  • Requests — гарантированный минимум, по нему планируется потребность в CPU.

  • Limits — верхняя граница потребления. Потребность в памяти планируется по limits, так как limits ≈ requests: запаса на кратковременные пики практически нет.

  • Сумма limits по CPU показывает верхнюю границу одновременного потребления и на практике не достигается, поэтому потребность в CPU планируется по requests с запасом, заложенным в рекомендуемых конфигурациях.

  • В Kubernetes ресурсы задаются в секции resources, а в Citeck Launcher лимит памяти контейнера и размер heap JVM задаются параметрами приложения memoryLimit и heapSize соответственно (см. Конфигурация серверного режима).

  • 1 Gi (GiB) = 1024 Mi (MiB); 1 vCPU = 1000m, то есть 100m — это 0.1 vCPU.

Правила пересчёта при изменении объёма документооборота

Правила общие для всех вариантов развёртывания.

Показатель

Формула

При 500 ГБ контента

Контент

суммарный объём файлов

500 ГБ (базовое допущение расчёта для продуктива)

База данных PostgreSQL

0.6 × контент + ~30 % на WAL, временные файлы и служебные данные

~400 ГБ

Поисковые индексы OpenSearch

0.5 × контент; при репликах индексов объём возрастает кратно числу копий

250 ГБ (диск ~300 ГБ)

Логи

≈ 1 ГБ на 500 именных пользователей в год

≈ 4 ГБ в год при 2000 именных (в подразделах закладывается с запасом)

Резервное копирование и место под резервные копии в настоящем расчёте не рассматриваются.

Ресурсы PostgreSQL в зависимости от объёма БД:

Объём базы данных

Выделенный сервер СУБД

На общей ВМ с контейнерами платформы

≤ 100 ГБ

4 vCPU / 16 GiB

2 vCPU / 4 GiB

≤ 1 ТБ

8 vCPU / 32 GiB

4 vCPU / 16 GiB

≤ 10 ТБ

16 vCPU / 64 GiB

8 vCPU / 32 GiB; при объёме контента свыше 2–3 ТБ — вынос на выделенный сервер

≤ 50 ТБ

24 vCPU / 128 GiB

вынос на выделенный сервер

Примечание

На общей ВМ ресурсы берутся из предыдущей строки таблицы: процессорные ядра и файловый кэш используются совместно со всей платформой.

Пороги по объёму БД достигаются при следующем объёме контента: БД 100 ГБ — при ~130 ГБ контента, БД 1 ТБ — при ~1.3 ТБ контента (1 ТБ / (0.6 × 1.3)).

Ориентир по OpenSearch: ~1 GiB heap на 20–30 ГБ индексов, heap не более 31 GiB и не более 50 % RAM узла.

Пример пересчёта: 2 ТБ контента
  1. PostgreSQL. Объём БД ≈ 2000 ГБ × 0.6 × 1.3 ≈ 1.6 ТБ — строка «≤ 10 ТБ»: 16 vCPU / 64 GiB на выделенном сервере или 8 vCPU / 32 GiB на общей ВМ.

  2. OpenSearch. Индексы ≈ 0.5 × 2000 ГБ = 1 ТБ (диск ~1.2 ТБ). По ориентиру требуется heap 33–50 GiB, что превышает предел 31 GiB: узел берётся с heap 31 GiB и 64 GiB RAM — это предел одного узла, при дальнейшем росте индексов применяются несколько узлов.

  3. S3-хранилище. Контент 2 ТБ — 1 узел за пределами кластера (Kubernetes) или на разделе данных ВМ.

  4. Платформа. Состав и ресурсы контейнеров, число worker-нод не меняются.

Итоговые значения по каждому способу развёртывания — в разделах «Сценарии по объёму контента» на страницах Сайзинг в Kubernetes и Сайзинг на одной ВМ: Citeck Launcher.

Когда расчёт требует пересмотра

Условие

Что меняется

Свыше 2000 именных (более 500 одновременных) пользователей

тиражирование Ecos Model, Gateway, Process; в Kubernetes — добавление worker-нод. На одной ВМ тиражирование микросервисов в Citeck Launcher пока не поддерживается (появится в будущих версиях, в пределах одной ВМ) — рекомендуется переход на Kubernetes

Объём БД свыше 1 ТБ

увеличение ресурсов PostgreSQL (CPU и RAM) по таблице выше

Объём контента свыше 2–3 ТБ

вынос СУБД и S3-хранилища на выделенные ВМ или в managed-сервисы; переход на кластерное S3-совместимое хранилище (см. S3-совместимое хранилище); развёртывание OpenSearch на нескольких узлах

Требования к RPO / RTO

кластеризация PostgreSQL, S3 и OpenSearch — в настоящем расчёте не учтена. Схема с одной ВМ отказоустойчивости не обеспечивает: требуется переход на Kubernetes

Что не входит в расчёт

  • Кластеризация и отказоустойчивость PostgreSQL, S3-хранилища и OpenSearch — репликация, Patroni, etcd, балансировщик подключений, многоузловое развёртывание S3, erasure coding, георезервирование, кворум OpenSearch из трёх узлов и реплики индексов.

  • Компоненты искусственного интеллекта — LLM (генеративные модели), ASR-модели для транскрибации аудио и видео (GigaAM, Whisper и аналоги), embedding-модели и векторное хранилище для RAG. Требуют отдельных GPU-ресурсов либо внешних inference-сервисов; состав компонентов — см. Механика выполнения AI-агентов, Настройка семантического поиска и Модуль записи совещаний.

  • Резервное копирование и место под резервные копии.

  • Инструменты CI/CD.

  • Мониторинг и сбор логов — учтены только в виде накладных расходов агентов на ноде или ВМ. Инструменты наблюдения за платформой — см. Spring Boot Admin.

  • Управляющие компоненты Kubernetes-кластера (control plane / master-ноды).