Merge branch 'reachability-update' into 'master'

изменила путь до папки с графом вызовов, добавила предупреждение, что...

See merge request CodeScoring/docs!647

Author: amaksimovv

docs/agent/reachability.en.md

@@ -45,15 +45,52 @@ To use this feature, you need to set two parameters:
       ```shell
       svace build ./gradlew clean build
       ```
+      Example for C#:
+      ```shell
+      svace build dotnet build
+      ```
    3. Analyze results and generate the call graph
       ```shell
       svace analyze --build-call-graph-only --license-server-url "http(s)://<codescoring_host>" --license-server-token "<token from step 1>"
       ```
-4. Upon successful completion of all steps, a file named `.svace-dir/analyze-res/call-graph/<project_name>-graph-order.json` containing the call graph will appear in the project directory.
+4. Upon successful completion of all steps, a file named `.svace-dir/analyze-res/call-graph-results/<project_name>-graph-order.json` containing the call graph will appear in the project directory.
+
+	!!! warning "Saving a file"
+		Prior to Svace version 5.0.260311, the call graph file was saved to the folder `.svace-dir/analyze-res/call-graph`
+
 5. Launch the scan using Johnny, for example:
     ```shell
-    johnny-linux-amd64 scan dir . --api_url "http(s)://<codescoring_host>" --api_token "<token from step 1>"  --cg-path .svace-dir/analyze-res/call-graph/<project_name>-graph-order.json  --cg-lang java
+    johnny-linux-amd64 scan dir . --api_url "http(s)://<codescoring_host>" --api_token "<token from step 1>"  --cg-path .svace-dir/analyze-res/call-graph-results/<project_name>-graph-order.json  --cg-lang java
     ```
+## Remote analysis
+
+In [Svace 5.0.260311](/on-premise/postgres-upgrade-compose/), it is now possible to use a remote analysis server. This allows you to take
+the construction of the call graph beyond the CI/CD pipeline, reduce the load on the assembly servers and optimize the continuous integration process.
+
+### Server configuration steps
+
+1. Specify environment variables
+```shell
+SVACE_LIC_SERVER_URL=http(s)://<codescoring_host>
+SVACE_LIC_SERVER_TOKEN=<токен CodeScoring>
+```
+2. Initialization
+```shell
+svace server init
+```
+3. Start the server
+```shell
+svace server start
+```
+4. Submit the project for analysis. After configuring the server, you do not need to specify the ```--license-server-url``` and ```--license-server-token``` license parameters.
+	```shell
+	svace remote --host <адрес сервера> analyze --build-call-graph-only
+	```
+
+	If necessary, you can add the parameters: ```--port```, ```--login```, ```--pass```, etc.
+
+For more information about the remote analysis server settings, see [the Svace documentation](https://svace.pages.ispras.ru/svace-website/docs/5.0.260306/user-guide.html#remote-analysis).
+
 
 ## Viewing results
 

docs/agent/reachability.md

@@ -45,16 +45,53 @@ hide:
       ```shell
       svace build ./gradlew clean build
       ```
+      Пример на языке C#:
+      ```shell
+      svace build dotnet build
+      ```
    3. Анализ результатов и построение графа вызовов
       ```shell
       svace analyze --build-call-graph-only --license-server-url "http(s)://<codescoring_host>" --license-server-token "<токен из п.1>"
       ```
-4. В случае успешного выполнения всех шагов в директории проекта появится файл `.svace-dir/analyze-res/call-graph/<project_name>-graph-order.json`, содержащий граф вызовов.
+4. В случае успешного выполнения всех шагов в директории проекта появится файл `.svace-dir/analyze-res/call-graph-results/<project_name>-graph-order.json`, содержащий граф вызовов.
+
+	!!! warning "Сохранение файла"
+		До версии Svace 5.0.260311 файл с графом вызовов сохранялся в папку  `.svace-dir/analyze-res/call-graph`
+
 5. Запустить сканирования с помощью Johnny, например:
     ```shell
-    johnny-linux-amd64 scan dir . --api_url "http(s)://<codescoring_host>" --api_token "<токен из п.1>"  --cg-path .svace-dir/analyze-res/call-graph/<project_name>-graph-order.json  --cg-lang java
+    johnny-linux-amd64 scan dir . --api_url "http(s)://<codescoring_host>" --api_token "<токен из п.1>"  --cg-path .svace-dir/analyze-res/call-graph-results/<project_name>-graph-order.json  --cg-lang java
     ```
 
+## Удаленный анализ
+
+В версии [Svace 5.0.260311](/on-premise/postgres-upgrade-compose/) появилась возможность использования сервера удалённого анализа. Это позволяет вынести
+построение графа вызовов за пределы CI/CD пайплайна, снизить нагрузку на сборочные серверы и оптимизировать процесс непрерывной интеграции.
+
+### Этапы настройки сервера
+
+1. Указать переменные окружения
+```shell
+SVACE_LIC_SERVER_URL=http(s)://<codescoring_host>
+SVACE_LIC_SERVER_TOKEN=<токен CodeScoring>
+```
+2. Инициализация
+```shell
+sace server init
+```
+3. Запустить сервер
+```shell
+svace server start
+```
+4. Отправить проект на анализ. После настройки сервера не нужно указывать параметры лицензии ```--license-server-url``` и ```--license-server-token```.
+	```shell
+	svace remote --host <адрес сервера> analyze --build-call-graph-only
+	```
+
+	При необходимости можно добавить параметры ```--port```, ```--login```, ```--pass``` и т.д.
+
+Подробнее с настройками сервера удалённого анализа можно ознакомиться в [документации Svace](https://svace.pages.ispras.ru/svace-website/docs/5.0.260306/user-guide.html#remote-analysis).
+
 ## Получение результатов
 
 В таблице уязвимостей с найденными достижимыми вызовами будет проставлена отметка в соответствующем столбце: