SonarQubePrepare@7. Подготовка задачи конфигурации анализа версии 7

Статья
02/24/2025

Подготовка конфигурации анализа SonarQube.

Заметка

Задачи SonarQube входят в расширение SonarQube для Azure DevOps, которое предварительно установлено в Azure DevOps Services. Дополнительные сведения и поддержку задач SonarQube и SonarQube см. в расширении SonarQube для Azure DevOps, SonarQube — Visual Studio Marketplaceи Sonar Community.

Синтаксис

# Prepare Analysis Configuration v7
# Prepare SonarQube Server analysis configuration.
- task: SonarQubePrepare@7
  inputs:
    SonarQube: # string. Required. SonarQube Server Endpoint. 
    scannerMode: 'dotnet' # 'dotnet' | 'cli' | 'other'. Required. Choose the way to run the analysis. Default: dotnet.
    #msBuildVersion: # string. Alias: dotnetScannerVersion. Optional. Use when scannerMode = dotnet. .NET Scanner Version. 
    #cliVersion: # string. Alias: cliScannerVersion. Optional. Use when scannerMode = cli. Scanner CLI Version. 
    #configMode: 'file' # 'file' | 'manual'. Required when scannerMode = cli. Mode. Default: file.
    #configFile: 'sonar-project.properties' # string. Optional. Use when scannerMode = cli && configMode = file. Settings File. Default: sonar-project.properties.
    #cliProjectKey: # string. Required when scannerMode = cli && configMode = manual. Project Key. 
    projectKey: # string. Required when scannerMode = dotnet. Project Key. 
    #cliProjectName: # string. Optional. Use when scannerMode = cli && configMode = manual. Project Name. 
    #projectName: # string. Optional. Use when scannerMode = dotnet. Project Name. 
    #cliProjectVersion: '1.0' # string. Optional. Use when scannerMode = cli && configMode = manual. Project Version. Default: 1.0.
    #projectVersion: '1.0' # string. Optional. Use when scannerMode = dotnet. Project Version. Default: 1.0.
    #cliSources: '.' # string. Required when scannerMode = cli && configMode = manual. Sources directory root. Default: ..
  # Advanced
    #extraProperties: # string. Additional Properties.

Входы

SonarQube - конечная точка сервера SonarQube
string. Обязательно.

Выберите конечную точку сервера SonarQube для проекта. Чтобы создать ее, щелкните ссылку "Управление" и создайте новую конечную точку сервера SonarQube, введите URL-адрес сервера и маркер.

scannerMode - Выберите способ выполнения анализа
string. Обязательно. Допустимые значения: dotnet (интеграция с .NET), cli (использование автономного интерфейса командной строки SonarScanner), other (интеграция с Maven или Gradle). Значение по умолчанию: dotnet.

dotnet (интеграция с .NET)
- Поместите эту задачу перед задачей сборки
- Добавьте задачу "Анализ кода" после задач MSBuild/VSTest
other (интеграция с Maven или Gradle)
- Поместите эту задачу перед задачей Maven/Gradle
- Установите флажок Run SonarQube Analysis в конфигурации задачи Maven/Gradle.
cli
- В других случаях можно использовать автономный сканер (sonar-сканер) и задать всю конфигурацию с этой задачей, а затем добавить задачу "Выполнить анализ кода".

msBuildVersion - версии сканера .NET
Псевдоним ввода: dotnetScannerVersion. string. Необязательный. Используется при scannerMode = dotnet.

Укажите версию используемого сканера .NET. Версии можно найти здесь.

средства проверки
Псевдоним ввода: cliScannerVersion. string. Необязательный. Используется при scannerMode = cli.

Укажите версию средства проверки CLI для использования. Версии можно найти здесь.

режима
string. Требуется, если scannerMode = cli. Допустимые значения: file (конфигурация Магазина с исходным кодом (sonar-project.properties)), manual (вручную укажите конфигурацию). Значение по умолчанию: file.

Выберите предпочтительный метод конфигурации.

параметров
string. Необязательный. Используется при scannerMode = cli && configMode = file. Значение по умолчанию: sonar-project.properties.

Дополнительные сведения доступны здесь.

cliProjectKey - ключ проекта
string. Требуется, если scannerMode = cli && configMode = manual.

Уникальный ключ проекта SonarQube, т. е. sonar.projectKey.

projectKey - ключ проекта
string. Требуется, если scannerMode = dotnet.

Уникальный ключ проекта SonarQube, т. е. sonar.projectKey.

имени проекта
string. Необязательный. Используется при scannerMode = cli && configMode = manual.

Имя проекта SonarQube, т. е. sonar.projectName.

имени проекта
string. Необязательный. Используется при scannerMode = dotnet.

Имя проекта SonarQube, т. е. sonar.projectName.

версии проекта
string. Необязательный. Используется при scannerMode = cli && configMode = manual. Значение по умолчанию: 1.0.

Версия проекта SonarQube, т. е. sonar.projectVersion.

версии проекта
string. Необязательный. Используется при scannerMode = dotnet. Значение по умолчанию: 1.0.

Версия проекта SonarQube, т. е. sonar.projectVersion.

корневой каталога источников
string. Требуется, если scannerMode = cli && configMode = manual. Значение по умолчанию: ..

Путь к корневому каталогу, содержаму исходные файлы. Это значение имеет значение sonar.sources свойству SonarQube.

extraProperties - дополнительные свойства
string. Значение по умолчанию: # Additional properties that will be passed to the scanner, \n# Put one key=value per line, example:\n# sonar.exclusions=**/*.bin.

дополнительные свойства передаваться сканеру. Укажите каждую пару key=value в новой строке.

Параметры управления задачами

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

Выходные переменные

Никакой.

Замечания

Заметка

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка
Выполняется в	Агент, DeploymentGroup
требования	Никакой
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любой
переменные settable	Любой
Версия агента	3.218.0 или более поздней версии
Категория задач	Строить

Поделиться через