Partager via


SonarQubePrepare@7 - Préparer la tâche Analysis Configuration v7

Préparez la configuration de l’analyse SonarQube.

Note

Les tâches SonarQube font partie de l’extension SonarQube pour Azure DevOps, qui est préinstallée dans Azure DevOps Services. Pour plus d’informations et de prise en charge des tâches SonarQube et SonarQube, consultez extension SonarQube pour Azure DevOps, SonarQube - Visual Studio Marketplaceet Sonar Community.

Syntaxe

# Prepare Analysis Configuration v7
# Prepare SonarQube 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.

Entrées

SonarQube - point de terminaison de serveur SonarQube
string. Obligatoire.

Sélectionnez le point de terminaison du serveur SonarQube pour votre projet. Pour en créer un, cliquez sur le lien Gérer et créez un point de terminaison de serveur SonarQube, entrez l’URL et le jeton de votre serveur.


scannerMode - Choisir le moyen d’exécuter l’analyse
string. Obligatoire. Valeurs autorisées : dotnet (Intégrer avec .NET), cli (Utiliser l’interface CLI SonarScanner autonome), other (Intégrer à Maven ou Gradle). Valeur par défaut : dotnet.

  • dotnet (intégrer à .NET)
    • Placez cette tâche avant votre tâche de génération
    • Ajoutez la tâche « Exécuter l’analyse du code » après les tâches MSBuild/VSTest
  • other (intégrer à Maven ou Gradle)
    • Placer cette tâche avant la tâche Maven/Gradle
    • Cochez la case « Exécuter l’analyse SonarQube » dans la configuration de la tâche Maven/Gradle.
  • cli
    • Pour d’autres cas, vous pouvez utiliser le scanneur autonome (sonar-scanneur) et définir toute la configuration avec cette tâche, puis ajouter la tâche « Exécuter l’analyse du code ».

msBuildVersion - version du scanneur .NET
Alias d’entrée : dotnetScannerVersion. string. Optionnel. Utilisez quand scannerMode = dotnet.

Spécifiez la version du scanneur .NET à utiliser. Les versions peuvent se trouver ici.


cli cli version
Alias d’entrée : cliScannerVersion. string. Optionnel. Utilisez quand scannerMode = cli.

Spécifiez la version du scanneur CLI à utiliser. Les versions peuvent se trouver ici.


mode
string. Obligatoire lorsque scannerMode = cli. Valeurs autorisées : file (configuration du Windows Store avec mon code source (sonar-project.properties)), manual (fournir manuellement la configuration). Valeur par défaut : file.

Choisissez votre méthode de configuration préférée.


fichier de paramètres configFile -
string. Optionnel. Utilisez quand scannerMode = cli && configMode = file. Valeur par défaut : sonar-project.properties.

Plus d’informations sont disponibles ici.


cliProjectKey - clé de projet
string. Obligatoire lorsque scannerMode = cli && configMode = manual.

Clé unique du projet SonarQube, c’est-à-dire sonar.projectKey.


projectKey - clé de projet
string. Obligatoire lorsque scannerMode = dotnet.

Clé unique du projet SonarQube, c’est-à-dire sonar.projectKey.


cliProjectName - nom du projet
string. Optionnel. Utilisez quand scannerMode = cli && configMode = manual.

Nom du projet SonarQube, c’est-à-dire sonar.projectName.


projectName - nom du projet
string. Optionnel. Utilisez quand scannerMode = dotnet.

Nom du projet SonarQube, c’est-à-dire sonar.projectName.


cliProjectVersion - version du projet
string. Optionnel. Utilisez quand scannerMode = cli && configMode = manual. Valeur par défaut : 1.0.

Version du projet SonarQube, c’est-à-dire sonar.projectVersion.


projectVersion - version du projet
string. Optionnel. Utilisez quand scannerMode = dotnet. Valeur par défaut : 1.0.

Version du projet SonarQube, c’est-à-dire sonar.projectVersion.


cliSources - racine du répertoire Sources
string. Obligatoire lorsque scannerMode = cli && configMode = manual. Valeur par défaut : ..

Chemin d’accès au répertoire racine contenant des fichiers sources. Cette valeur est définie sur la propriété sonar.sources SonarQube.


extraProperties - propriétés supplémentaires
string. Valeur par défaut : # Additional properties that will be passed to the scanner, \n# Put one key=value per line, example:\n# sonar.exclusions=**/*.bin.

Propriétés supplémentaires à passer au scanneur. Spécifiez chaque paire clé=valeur sur une nouvelle ligne.


Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Note

Les tâches SonarQube font partie de l’extension SonarQube pour Azure DevOps, qui est préinstallée dans Azure DevOps Services. Pour plus d’informations et de prise en charge des tâches SonarQube et SonarQube, consultez extension SonarQube pour Azure DevOps, SonarQube - Visual Studio Marketplaceet Sonar Community.

Exigences

Exigence Description
Types de pipelines YAML, build classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent 3.218.0 ou version ultérieure
Catégorie de tâche Construire