Help:Introduction: Difference between revisions

From Svacer Wiki
VisualWikitext
m (change postgresql version)
No edit summary
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Help]]
[[Category:Help]]
== Введение ==
[[:Category:Help]]


Svacer предназначен для хранения и обработки результатов статического анализатора Svace и других анализаторов, поддерживающих формат [[Help:Sarif#Загрузка_на_сервер_из_SARIF|SARIF]].
__TOC__


Svacer состоит из двух исполняемых файлов: сервера и клиента
== Введение ==
* Сервер используется для хранения и обработки результатов анализа, для [[Help:Installation|запуска]] нужен PostgreSQL с созданной БД
Сервер историй '''Svacer''' ('''''Svace Server''''') предназначен для хранения и обработки результатов работы статического анализатора Svace. Он разработан с целью заменить старый сервер историй, встроенный в анализатор Svace.
* Клиент — для взаимодействия с сервером, для него никакие зависимости не требуются
Допускается одновременное использование старого и нового серверов.
 
Запущенный сервер Svacer предоставляет [[Help:UI_manual#Авторизация_в_пользовательском_интерфейсе_сервера_Svacer|web-UI]] и [[Help:Public_API|REST API]] для взаимодействия.  


В клиенте Svacer доступны команды для [[Help:Import_from_Svace|импорта]] предупреждений, [[Help:Import_from_Svace#Загрузка_данных_на_сервер|загрузки]] их на сервер и прочего взаимодействия с сервером.


=== Термины ===
=== Термины ===
Line 16: Line 13:
{| class="wikitable"
{| class="wikitable"
|-
|-
| Project
| ''Project''
| Проект, подлежащий анализу. По умолчанию именем проекта считается имя директории, в которой был запущен ''svace build'' и ''svace analyze''.
| Проект, подлежащий анализу. По умолчанию именем проекта считается имя директории, в которой был запущен ''svace build'' и ''svace analyze''.
На сервере проект содержит в себе несколько веток с результатами работы анализатора
На сервере проект содержит в себе несколько '''branch''' с результатами работы анализатора
|-
|-
| Branch (ветка)
| ''Branch (ветка)''
| Ветка в проекте с результатами работы анализатора. По умолчанию — master
| Ветка в проекте с результатами работы анализатора. По умолчанию проект имеет одну ветку — master
|-
|-
| Snapshot (снимок)
| ''Snapshot (снимок)''
| Результат работы ''svace analyze'', импортированный в промежуточное хранилище или на сервер. Содержит:
| Результат работы ''svace analyze'', импортированный в промежуточное хранилище или на сервер. Содержит:
* имя проекта;
* имя проекта;
Line 31: Line 28:
* вспомогательная информация для навигации по исходникам;
* вспомогательная информация для навигации по исходникам;
* дополнительные данные;
* дополнительные данные;
Допускается импорт снимков без исходного кода и дополнительной информации
Допускается импортирование снимков без исходного кода и дополнительной информации
|-
| ''Marker (маркер, предупреждение)''
| Предупреждение от Svace с информацией о позиции в исходном файле
|-
|-
| Marker (маркер, предупреждение)
| ''Svacer''
| Предупреждение от статического анализатора с информацией о позиции в исходном файле
| Svace History Server, а также исполняемый файл, содержащий код сервера
|-
|-
| Разметка
| ''Разметка''
| Проставление статуса маркера с опциональным добавлением комментария
| Проставление статуса маркера с опциональным добавлением комментария
|}
|}


=== Состав дистрибутива ===
=== Состав дистрибутива ===
Line 44: Line 45:
{| class="wikitable"
{| class="wikitable"
|-  
|-  
| bin/svacer-server<br>bin/svacer-server.exe
| '''bin/svacer<br>bin/svacer.exe'''
| Бинарный файл сервера
| Бинарный файл сервера и утилита для импортирования результатов. Режим работы зависит от аргументов
|-
| '''support/svace-migration/svace-migration.jar'''
| Утилита подготовки данных для импорта из старого сервера историй.
Требует JDK для запуска. Может использоваться JDK из состава дистрибутива Svace
|-
|-
| bin/svacer<br>bin/svacer.exe
| '''extra/docker-compose*.yml''' || Docker-compose файлы для запуска БД PostgreSQL и Svacer в docker-контейнерах
| Бинарный файл клиента
|-
|-
| extra/docker-compose*.yml
| '''integrations/vscode''' || Расширение для Visual Studio Code и документация на него
| docker-compose файлы для запуска БД PostgreSQL и Svacer в docker-контейнерах
|}
|}


=== Зависимости ===
=== Зависимости ===
Line 58: Line 62:
{| class="wikitable"
{| class="wikitable"
|-  
|-  
| PostgreSQL версии 15 и выше. Нужен только для сервера
| PostgreSQL
| Параметры подключения определяются при запуске сервера аргументом '''--pg''' или переменной окружения SVACER_PG_URL. По умолчанию: '''postgres://svace:svace@0.0.0.0:5432/svace'''<br/>
версии не ниже 10-й
Можно запускать PostgreSQL в docker-контейнере, но в production мы рекомендуем использовать выделенный сервер
| Параметры подключения определяются аргументом при запуске сервера или переменной окружения SVACER_PG_URL. По умолчанию, используется следующий connect URL:
'''postgres://svace:svace@0.0.0.0:5432/svace'''<br>
Можно использовать PostgreSQL в docker-контейнере.<br>
'''Настоятельно рекомендуем''' использовать выделенный сервер для хранения БД, особенно в production
|-
|-
| libc.so<br>libpthread.so<br>libdl.so<br>linux-vdso.so
| libc.so<br>libpthread.so<br>libdl.so<br>linux-vdso.so
| Серверная часть написана на Go с CGO_ENABLED=1 ввиду необходимости читать sqlite-файлы из результатов работы анализатора Svace
| Серверная часть написана на Go с CGO_ENABLED=1 ввиду необходимости читать sqlite-файлы из результатов работы анализатора Svace
|-
|-
| Директория для хранения object storage
| Выделенная директория для хранения object storage
| Сервер использует встроенную key-value database для хранения информации об исходном коде: контент-файлов и вспомогательной информации для навигации
| Сервер использует встроенную key-value database для хранения информации об исходном коде: контент-файлов и вспомогательной информации для навигации
|-
|-
| Svace
| svace
| Нужен для импорта результатов анализа из .svace-dir. При этом лицензия на Svace нужна только для анализа, для импорта она не требуется
| Для импорта данных на сервер историй требуется наличие Svace на хосте, откуда происходит импорт. Svace используется для получения информации из .svace-dir
|}
|}


=== Используемые порты ===
=== Используемые порты ===
Line 78: Line 86:
|-
|-
| 3002
| 3002
| Используется для предоставления gRPC API (внутренний API для загрузки данных на сервер)
| Используется для предоставления gRPC API.
gRPC API является внутренним и предназначен для загрузки данных на сервер
|-
|-
| 8080
| 8080
| Используется для REST API и web-сервера для предоставления web-UI
| Используется для предоставления REST API и web-сервера для предоставления web-UI
|}
|}


=== Системные требования ===
 
{| class="wikitable"
[[#Top|Вверх]]
|-
| CPU
| x86-64. Для больших проектов рекомендуется не менее 8 ядер
|-
| RAM
| От 4 ГБ. При обновлении между версиями лучше не меньше 8 ГБ. Для больших проектов — 16+ ГБ
|-
| HDD
| От 1 ГБ до нескольких ТБ при хранении множества снимков больших проектов
|-
| OS
|
* Ubuntu 18 и выше
* Debian 10 и выше
* RHEL/CentOS 8
* Astra Linux Special Edition 1.7, базовый уровень защищенности
* Alt Linux p8 и выше
* Microsoft Windows 10
|-
| Browser
|
В качестве клиента для веб-интерфейса Svacer
* Chrome 103 и выше
* Firefox 100 и выше
* Opera 89 и выше
* Safari 16 и выше
* Edge 103 и выше
|}

Revision as of 18:46, 19 December 2022

Category:Help

Введение

Сервер историй Svacer (Svace Server) предназначен для хранения и обработки результатов работы статического анализатора Svace. Он разработан с целью заменить старый сервер историй, встроенный в анализатор Svace. Допускается одновременное использование старого и нового серверов.


Термины

Project Проект, подлежащий анализу. По умолчанию именем проекта считается имя директории, в которой был запущен svace build и svace analyze.

На сервере проект содержит в себе несколько branch с результатами работы анализатора

Branch (ветка) Ветка в проекте с результатами работы анализатора. По умолчанию проект имеет одну ветку — master
Snapshot (снимок) Результат работы svace analyze, импортированный в промежуточное хранилище или на сервер. Содержит:
  • имя проекта;
  • имя ветки;
  • результаты анализа (предупреждения);
  • исходники, которые были включены в build, на котором производился анализ;
  • вспомогательная информация для навигации по исходникам;
  • дополнительные данные;

Допускается импортирование снимков без исходного кода и дополнительной информации

Marker (маркер, предупреждение) Предупреждение от Svace с информацией о позиции в исходном файле
Svacer Svace History Server, а также исполняемый файл, содержащий код сервера
Разметка Проставление статуса маркера с опциональным добавлением комментария


Состав дистрибутива

bin/svacer
bin/svacer.exe 		Бинарный файл сервера и утилита для импортирования результатов. Режим работы зависит от аргументов
support/svace-migration/svace-migration.jar Утилита подготовки данных для импорта из старого сервера историй.

Требует JDK для запуска. Может использоваться JDK из состава дистрибутива Svace

extra/docker-compose*.yml Docker-compose файлы для запуска БД PostgreSQL и Svacer в docker-контейнерах
integrations/vscode Расширение для Visual Studio Code и документация на него


Зависимости

PostgreSQL

версии не ниже 10-й

Параметры подключения определяются аргументом при запуске сервера или переменной окружения SVACER_PG_URL. По умолчанию, используется следующий connect URL:

postgres://svace:svace@0.0.0.0:5432/svace
Можно использовать PostgreSQL в docker-контейнере.
Настоятельно рекомендуем использовать выделенный сервер для хранения БД, особенно в production

libc.so
libpthread.so
libdl.so
linux-vdso.so 		Серверная часть написана на Go с CGO_ENABLED=1 ввиду необходимости читать sqlite-файлы из результатов работы анализатора Svace
Выделенная директория для хранения object storage Сервер использует встроенную key-value database для хранения информации об исходном коде: контент-файлов и вспомогательной информации для навигации
svace Для импорта данных на сервер историй требуется наличие Svace на хосте, откуда происходит импорт. Svace используется для получения информации из .svace-dir


Используемые порты

Приведены значения по умолчанию. Все значения могут быть переопределены.

3002 Используется для предоставления gRPC API.

gRPC API является внутренним и предназначен для загрузки данных на сервер

8080 Используется для предоставления REST API и web-сервера для предоставления web-UI


Вверх

Retrieved from "https://svacer.ispras.ru/mediawiki/index.php?title=Help:Introduction&oldid=275"