Поддержка edt-ripper для подготовки файла с замечаниями для SonarQube в формате bsl-ls, поддержка SQ>=10.3 при использовании stebi

README.md

@@ -19,9 +19,10 @@
 
 ## Ограничения
 
+1. Хранение исходников в корне репозитория или в каталоге первого уровня (например, в `src`) не рекомендуется.
 1. Для шага подготовки требуется любой агент с меткой `agent`.
 1. Для запуска шага анализа SonarQube требуется агент с меткой `sonar`.
-1. Для запуска шагов, работающих с EDT (валидация, трансформация формата исходников) требуется агент с меткой `edt` (если используется несколько версий EDT необходимо к метке добавить версию, например `[email protected]:x86_64`) и агент с меткой `oscript`, на котором глобально установлена библиотека [stebi](https://github.com/Stepa86/stebi) версии 1.9.1 или новее.
+1. Для запуска шагов, работающих с EDT (валидация, трансформация формата исходников) требуется агент с меткой `edt` (если используется несколько версий EDT необходимо к метке добавить версию, например `[email protected]:x86_64`) и агент с меткой `oscript`, на котором глобально установлена библиотека [stebi](https://github.com/Stepa86/stebi) версии 1.11.1 и выше или [edt-ripper](https://github.com/bia-technologies/edt_ripper).
 1. Для запуска шагов, работающих с 1С (подготовка, синтаксический контроль и т.д.) требуется агент с меткой, совпадающей со значением в поле `v8version` файла конфигурации.
 1. В качестве ИБ используется файловая база, создаваемая в каталоге `./build/ib`. При необходимости вы можете создать пользователей на фазе инициализации ИБ.
 
@@ -38,7 +39,8 @@
 1. Запуск BDD сценариев с сохранением результатов в формате Allure.
 1. Запуск юнит-тестов с помощью фреймворка YAXUnit с сохранением результатов в формате jUnit и Allure.
 1. Запуск синтаксического контроля средствами конфигуратора и сохранение результатов в виде отчета jUnit.
-1. Запуск валидации проекта средствами EDT и конвертация отчета в формате generic issues.
+1. Валидация проекта средствами EDT и трансформация отчета EDT в формат BSL LS с помощью `edt-ripper` или Generic Issue с помощью `stebi`.
+
 1. Запуск статического анализа для SonarQube.
 1. Публикация результатов junit и Allure в интерфейс Jenkins.
 1. Рассылка результатов сборки на почту и в Telegram.
@@ -148,15 +150,17 @@ pipeline1C()
   * Если в репозитории существует файл `./tools/syntax-check-exception-file.txt`, то команде запуска синтаксического контроля конфигурации данный файл будет передаваться как файл с исключениями сообщений об ошибках (параметр `--exception-file`) (`syntaxCheck` -> `exceptionFile`).
   * Конфигурационный файл по умолчанию уже содержит ряд "режимов проверки" для синтаксического контроля конфигурации (`syntaxCheck` -> `checkModes`).
 * Трансформация результатов валидации EDT:
-  * По умолчанию из результатов анализа исключаются замечания, сработавшие на модулях с включенным запретом редактирования (желтый куб с замком) (параметры `resultsTransform` -> `removeSupport` и `resultsTransform` -> `supportLevel`).
+  * Используется `stebi` (параметр `resultsTransform` -> `transformer`)
+  * Формат файла - `generic issues` для SonarQube 10.3+ (параметр `resultsTransform` -> `genericIssueFormat`)
+  * `stebi` исключает из результатов анализа замечания, сработавшие на модулях с включенным запретом редактирования (желтый куб с замком) (параметры `resultsTransform` -> `removeSupport` и `resultsTransform` -> `supportLevel`).
 * Анализ SonarQube:
   * Предполагается наличие единственной настройки `SonarQube installation` (`sonarqube` -> `sonarQubeInstallation`).
   * Используется `sonar-scanner` из переменной окружения `PATH` (`sonarqube` -> `useSonarScannerFromPath`).
   * Если использование `sonar-scanner` из переменной окружения `PATH` выключено, предполагается наличие настроенного глобального инструмента `SonarQube Scanner` с идентификатором инструмента `sonar-scanner` (`sonarqube` -> `sonarScannerToolName`).
   * Применяется расчет аргументов командной строки для работы [`branch plugin`](https://github.com/mc1arke/sonarqube-community-branch-plugin) или коммерческих версий SonarQube (`sonarqube` -> `branchAnalysisConfiguration`).
   * Если разработка ведется с использованием подсистемы [БСП "Обновление версии ИБ"](https://its.1c.ru/db/bsp315doc#content:4:1:issogl1_обновление_версии_иб), то в значение параметра `sonar.projectVersion=$configurationVersion` утилиты `sonar-scanner` можно передавать версию из созданного общего модуля. Для этого необходимо заполнить параметр (`sonarqube` -> `infoBaseUpdateModuleName`). Если параметр не заполнен, версия передается из корня конфигурации.
   * По умолчанию шаг анализа не дожидается окончания фонового задания на сервере SonarQube и не анализирует результат прохождения Порога качества (`sonarqube` -> `waitForQualityGate`).
-  * Если выполнялась валидация EDT, результаты валидации в формате `generic issues` передаются утилите `sonar-scanner` как значение параметра `sonar.externalIssuesReportPaths`.
+  * Если выполнялась валидация EDT, результаты валидации передаются утилите `sonar-scanner` как значение параметра `sonar.externalIssuesReportPaths` при использовании `stebi` или как значение параметра `sonar.bsl.languageserver.reportPaths` при использовании `edt-ripper`.
 * Рассылка уведомлений:
   * Электронная почта:
     * Для отправки используется плагин [`email-ext`](https://plugins.jenkins.io/email-ext). Шаблоны сообщений конфигурируются в настройках плагина. 
@@ -173,9 +177,9 @@ pipeline1C()
 
 ## Настройка загрузки расширений
 
-Если у вас есть расширения которые необходимо загрузить в базу для проведения тестов и проверок, это можно сделать на этапе подготовки базы.
+Если у вас есть расширения, которые необходимо загрузить в базу для проведения тестов и проверок, это можно сделать на этапе подготовки базы.
 
-* При загрузке из исходников расширения должны быть в том же формате(edt или конфигуратора) что и основная конфигурация.
+* При загрузке из исходников расширения должны быть в том же формате (edt или конфигуратора), что и основная конфигурация.
 * Для загрузки расширений необходимо описать каждое из них в массиве (`initInfobase` -> `extensions`).
 
 Для загрузки расширений в информационную базу необходимо выполнить следующие шаги:
@@ -233,4 +237,9 @@ pipeline1C()
 
   * Добавить расширение `YAXUnit` и дополнительные расширения с тестами можно в `jobConfiguration.json` -> `initInfobase` -> `extensions`. Они будут загружены при инициализации ИБ.
   * Если ваши тесты размещены в отдельных расширениях, скопируйте файл `./resources/yaxunit.json` из текущей библиотеки в свой репозиторий (`./tools/yaxunit.json`) и перечислите в нем имена ваших расширений.
-  * Если используется собственный файл `tools/yaxunit.json`, то значение параметра reportPath в нем должно быть равно `./build/out/yaxunit/junit.xml`
+  * Если используется собственный файл `tools/yaxunit.json`, то значение параметра `reportPath` в нем должно быть равно `./build/out/yaxunit/junit.xml`
+
+## Настройка трансформации результата валидации EDT
+
+  * При использовании SonarQube версии <10.3 и `stebi` формат отчета должен быть `Generic_Issue` (параметр `resultsTransform` -> `genericIssueFormat`)
+  * Трансформацию результатов может выполнять `edt-ripper` (параметр `resultsTransform` -> `transformer`). В этом случае замечания будут загружены в SonarQube в формате BSL LS, что позволяет полноценно управлять ими в SonarQube.

build.gradle.kts

@@ -5,8 +5,8 @@ plugins {
     groovy
     jacoco
     id("com.mkobit.jenkins.pipelines.shared-library") version "0.10.1"
-    id("com.github.ben-manes.versions") version "0.28.0"
-    id("org.jenkins-ci.jpi") version "0.38.0" apply false
+    id("com.github.ben-manes.versions") version "0.51.0"
+    id("org.jenkins-ci.jpi") version "0.52.0-rc.1" apply false
 }
 
 repositories {
@@ -28,27 +28,29 @@ tasks {
 }
 
 java {
-    sourceCompatibility = JavaVersion.VERSION_1_8
+    sourceCompatibility = JavaVersion.VERSION_11
+    targetCompatibility = JavaVersion.VERSION_11
 }
 
-val junitVersion = "5.6.1"
+val junitVersion = "5.11.0"
 val spockVersion = "1.3-groovy-2.4"
-val groovyVersion = "2.4.19"
-val slf4jVersion = "1.8.0-beta4"
-var jacksonVersion = "2.9.8"
+val groovyVersion = "2.4.21"
+val slf4jVersion = "2.0.16"
+val jsonschemaVersion = "4.36.0"
 
 dependencies {
     implementation("org.codehaus.groovy", "groovy-all", groovyVersion)
 
-    // jackson
-    implementation("com.fasterxml.jackson.module", "jackson-module-jsonSchema", jacksonVersion)
+    // jsonschema-generator
+    implementation("com.github.victools", "jsonschema-generator", jsonschemaVersion)
+    implementation("com.github.victools", "jsonschema-module-jackson", jsonschemaVersion)
 
     // unit-tests
-    testImplementation("org.junit.jupiter", "junit-jupiter-api", junitVersion)
     testRuntimeOnly("org.junit.jupiter", "junit-jupiter-engine", junitVersion)
+    testImplementation("org.junit.jupiter", "junit-jupiter-api", junitVersion)
 
-    testImplementation("org.assertj", "assertj-core", "3.15.0")
-    testImplementation("org.mockito", "mockito-core", "5.11.0")
+    testImplementation("org.assertj", "assertj-core", "3.26.3")
+    testImplementation("org.mockito", "mockito-core", "5.13.0")
 
     testImplementation("org.slf4j", "slf4j-api", slf4jVersion)
     testImplementation("org.slf4j", "slf4j-simple", slf4jVersion)
@@ -74,7 +76,7 @@ tasks.test {
     }
 
     reports {
-        html.isEnabled = true
+        html.required.set(true)
     }
 }
 
@@ -85,8 +87,8 @@ tasks.check {
 
 tasks.jacocoTestReport {
     reports {
-        xml.isEnabled = true
-        xml.destination = File("$buildDir/reports/jacoco/test/jacoco.xml")
+        xml.required.set(true)
+        xml.outputLocation.set(File("$buildDir/reports/jacoco/test/jacoco.xml"))
     }
 }
 
@@ -101,20 +103,27 @@ sharedLibrary {
     coreVersion.set(jenkinsIntegration.downloadDirectory.file("core-version.txt").map { it.asFile.readText().trim() })
     // TODO: retrieve downloaded plugin resource
     pluginDependencies {
-        dependency("org.jenkins-ci.plugins", "pipeline-build-step", "2.12")
-        dependency("org.jenkins-ci.plugins", "pipeline-utility-steps", "2.8.0")
-        dependency("org.jenkins-ci.plugins", "git", "4.4.4")
-        dependency("org.jenkins-ci.plugins", "http_request", "1.15")
-        dependency("org.6wind.jenkins", "lockable-resources", "2.7")
-        dependency("ru.yandex.qatools.allure", "allure-jenkins-plugin", "2.28.1")
-        val declarativePluginsVersion = "1.6.0"
+        dependency("org.jenkins-ci.plugins", "pipeline-build-step", "540.vb_e8849e1a_b_d8")
+        dependency("org.jenkins-ci.plugins", "pipeline-utility-steps", "2.17.0")
+        dependency("org.jenkins-ci.plugins", "git", "5.2.2")
+        dependency("org.jenkins-ci.plugins", "http_request", "1.19")
+        dependency("org.jenkins-ci.plugins", "timestamper", "1.27")
+        dependency("org.jenkins-ci.plugins", "credentials", "1371.vfee6b_095f0a_3")
+        dependency("org.jenkins-ci.plugins", "token-macro", "400.v35420b_922dcb_")
+        dependency("org.jenkins-ci.plugins.workflow", "workflow-step-api", "678.v3ee58b_469476")
+
+        dependency("org.jenkins-ci.modules", "sshd", "3.329.v668e35efc720")
 
+        dependency("org.6wind.jenkins", "lockable-resources", "1255.vf48745da_35d0")
+        dependency("ru.yandex.qatools.allure", "allure-jenkins-plugin", "2.31.1")
+        dependency("io.jenkins.blueocean", "blueocean-pipeline-api-impl", "1.27.14")
+        dependency("sp.sd", "file-operations", "266.v9d4e1eb_235b_a_")
+
+        val declarativePluginsVersion = "2.2214.vb_b_34b_2ea_9b_83"
 
         dependency("org.jenkinsci.plugins", "pipeline-model-api", declarativePluginsVersion)
-        dependency("org.jenkinsci.plugins", "pipeline-model-declarative-agent", "1.1.1")
         dependency("org.jenkinsci.plugins", "pipeline-model-definition", declarativePluginsVersion)
         dependency("org.jenkinsci.plugins", "pipeline-model-extensions", declarativePluginsVersion)
-        dependency("io.jenkins.blueocean", "blueocean-pipeline-api-impl", "1.25.3")
-        dependency("sp.sd", "file-operations", "214.v2e7dc7f25757")
+        dependency("org.jenkinsci.plugins", "pipeline-model-declarative-agent", "1.1.1")
     }
 }

resources/globalConfiguration.json

@@ -92,6 +92,8 @@
     "publishToJUnitReport": true
   },
   "resultsTransform": {
+    "transformer": "stebi",
+    "genericIssueFormat": "Generic_Issue_10_3",
     "removeSupport": true,
     "supportLevel": 0
   },