Типовой сайзинг
Раздел содержит типовой расчёт инфраструктуры для развёртывания Citeck. На этой странице собрано то, что одинаково для всех вариантов развёртывания: целевая нагрузка, итоговые конфигурации, состав и ресурсы контейнеров платформы, правила пересчёта с учётом фактического объёма документооборота и границы применимости. Детальный расчёт нод и виртуальных машин вынесен в подразделы по способу развёртывания.
Примечание
Расчёт выполнен для 2000 именных пользователей и применим при любом их числе от 100 до 2000. Для установок до 100 именных пользователей на одной ВМ предусмотрен облегчённый профиль — см. Сайзинг на одной ВМ: Citeck Launcher.
Ресурсы контейнеров и подов взяты из раздела Менеджмент ресурсов подов и контейнеров.
Подразделы
Worker-ноды продуктивного кластера и кластера для разработки и тестирования (Test или Dev + Test): типоразмер ноды, количество нод с резервированием N+1, Persistent Volumes и диски вне кластера.
Конфигурации ВМ для развёртывания с помощью Citeck Launcher 2.x — профили до 100 и до 2000 именных пользователей, разметка дисков, ограничения схемы с одной ВМ.
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 (Менеджмент ресурсов подов и контейнеров).
См. также
Менеджмент ресурсов подов и контейнеров — исходные значения
resourcesи параметры JVM для каждого микросервиса.Сервисы Docker — назначение образов и переменные окружения.
Архитектура — состав микросервисов, зависимости компонентов и схема хранения данных.
Методика расчёта
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 ТБ контента
PostgreSQL. Объём БД ≈ 2000 ГБ × 0.6 × 1.3 ≈ 1.6 ТБ — строка «≤ 10 ТБ»: 16 vCPU / 64 GiB на выделенном сервере или 8 vCPU / 32 GiB на общей ВМ.
OpenSearch. Индексы ≈ 0.5 × 2000 ГБ = 1 ТБ (диск ~1.2 ТБ). По ориентиру требуется heap 33–50 GiB, что превышает предел 31 GiB: узел берётся с heap 31 GiB и 64 GiB RAM — это предел одного узла, при дальнейшем росте индексов применяются несколько узлов.
S3-хранилище. Контент 2 ТБ — 1 узел за пределами кластера (Kubernetes) или на разделе данных ВМ.
Платформа. Состав и ресурсы контейнеров, число 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-ноды).