Merge branch 'requirements' into 'master'

updated server requirements

See merge request CodeScoring/docs!617

Author: amaksimovv

docs/on-premise/server-requirements.en.md

@@ -11,25 +11,44 @@ Installation of the on-premise version is possible on **GNU/Linux** distribution
 
 ## Server resources
 
-Minimum requirements to run: **16Gb RAM, 8 CPU cores**.
+### Baseline requirements for production installation
 
-Recommended requirements: **32Gb RAM, 16 CPU cores**.
+- Minimum supported resources for application servers: **32Gb RAM, 16 CPU cores**.
 
-Additionally, make sure that the space where the directory with docker data is located (data-root docker, by default /var) has at least **20Gb of memory**. At the same time, for smooth operation of the system, it is necessary to reserve **disk space based on the size of the analyzed repositories, multiplied by three**.
+!!! warning "Resource recommendation"
+    For production installations, it is not recommended to go below these values, as this may lead to performance degradation and unstable platform operation.
+
+### Data services requirements
+
+- **PostgreSQL**: from **32Gb RAM**;
+- **Redis**: from **2Gb RAM**;
+- `shm` size for **PostgreSQL**: at least **4Gb**;
+- If an [external database](/on-premise/external-database.en/) is used, **PostgreSQL** is recommended to have at least **64Gb RAM**.
+
+### Storage requirements
+
+- For **CodeScoring.SCA** with VCS projects, calculate `analysis-root` volume based on the size of analyzed repositories multiplied by three;
+- For **CodeScoring.SCA** with CLI projects and for **CodeScoring.OSA**, there is no mandatory `×3` storage formula;
+- For the offline installation allocate at least **300Gb** for the [CodeScoring Index](/feeds/index.en/) database, with additional capacity reserved for further updates.
+
+### Example of a high-load installation
+
+- Database server: **96Gb RAM, 24 CPU cores**;
+- Application server: **192Gb RAM, 48 CPU cores**.
 
 ## Supported versions of external services
 
 When using your own database instances, make sure that their versions meet the requirements below:
 
 ### Redis
 
-- Minimum version: **7.0.0**
-- Tested version: **7.4.6**
+- Minimum version: **7.0.0**;
+- Tested version: **7.4.6**.
 
 ### PostgreSQL
 
-- Minimum version: **13.x** (any minor)
-- Tested version: **13.21**
+- Minimum version: **15.x** (any minor);
+- Tested version: **15.15**.
 
 Using other major branches does not guarantee correct results and may lead to errors or performance degradation.
 
@@ -149,4 +168,4 @@ An example of a request from the platform to the Index API with data on hashes o
  "sha256": "e01c736a351633932e8b3ed041e553f67968e07d35d2c153b02b60e910a8c433"
  }
 ]
-```
+```

docs/on-premise/server-requirements.md

@@ -11,25 +11,44 @@ hide:
 
 ## Ресурсы сервера
 
-Минимальные требования для запуска: **16Gb RAM, 8 ядер CPU**.
+### Базовые требования для рабочей среды
 
-Рекомендуемые требования: **32Gb RAM, 16 ядер CPU**.
+- Минимально допустимые требования для серверов приложения: **32Gb RAM, 16 ядер CPU**.
 
-Дополнительно стоит убедиться, что раздел, на котором размещается директория с данными docker (data-root docker, по умолчанию `/var`), имеет **не менее 20Gb** памяти. При этом для бесперебойного функционирования системы необходимо **резервировать дисковое пространство из расчета размера анализируемых репозиториев, умноженного на три**.
+!!! warning "Рекомендация по ресурсам"
+    Для установки в рабочей среде не рекомендуется опускаться ниже указанных значений, так как это может приводить к деградации производительности и нестабильной работе платформы.
+
+### Требования к сервисам данных
+
+- **PostgreSQL**: от **32Gb RAM**;
+- **Redis**: от **2Gb RAM**;
+- Размер `shm` для **PostgreSQL**: не менее **4Gb**;
+- При использовании [внешней базы данных](/on-premise/external-database/) для **PostgreSQL** рекомендуется от **64Gb RAM**.
+
+### Требования к хранилищу
+
+- Для модуля **CodeScoring.SCA** при использовании VCS-проектов объем тома `analysis-root` рассчитывается из размера анализируемых репозиториев, умноженного на три;
+- Для модуля **CodeScoring.SCA** при использовании CLI-проектов и для модуля **CodeScoring.OSA** отдельные требования по формуле `×3` не предъявляются;
+- При оффлайн-установке для базы данных [CodeScoring Index](/feeds/) необходимо выделять от **300Gb** с запасом под последующие обновления;
+
+### Пример высоконагруженной инсталляции
+
+- Сервер базы данных: **96Gb RAM, 24 ядер CPU**;
+- Сервер приложений: **192Gb RAM, 48 ядер CPU**.
 
 ## Поддерживаемые версии внешних сервисов
 
 При использовании собственных экземпляров баз данных убедитесь, что их версии соответствуют требованиям ниже:
 
 ### Redis
 
-- Минимальная версия: **7.0.0**
-- Протестированная версия: **7.4.6**
+- Минимальная версия: **7.0.0**;
+- Протестированная версия: **7.4.6**.
 
 ### PostgreSQL
 
-- Минимальная версия: **13.x** (любая минорная)
-- Протестированная версия: **13.21**
+- Минимальная версия: **15.x** (любая минорная);
+- Протестированная версия: **15.15**.
 
 Использование других мажорных веток не гарантирует корректный результат и может приводить к ошибкам или снижению производительности.
 
@@ -150,4 +169,3 @@ hide:
   }
 ]
 ```
-