Compartir vía

SonarQubePrepare@7: tarea Preparar la configuración de análisis v7

  • Artículo

Prepare la configuración de análisis de SonarQube.

Nota

Las tareas sonarQube forman parte de la extensión SonarQube para Azure DevOps, que está preinstalada en Azure DevOps Services. Para obtener más información y compatibilidad con tareas de SonarQube y SonarQube, consulte extensión SonarQube para Azure DevOps, SonarQube: Visual Studio Marketplacey Sonar Community.

Sintaxis

# 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.

Entradas

de punto de conexión de servidor SonarQube
string. Obligatorio.

Seleccione el punto de conexión del servidor SonarQube para el proyecto. Para crear uno, haga clic en el vínculo Administrar y cree un nuevo punto de conexión de servidor SonarQube, escriba la dirección URL y el token del servidor.


scannerMode - Elegir la manera de ejecutar el de análisis
string. Obligatorio. Valores permitidos: dotnet (integración con .NET), cli (uso de la CLI de SonarScanner independiente), other (integración con Maven o Gradle). Valor predeterminado: dotnet.

  • dotnet (integración con .NET)
    • Coloque esta tarea antes de la tarea de compilación.
    • Agregue la tarea "Ejecutar análisis de código" después de las tareas de MSBuild/VSTest
  • other (integración con Maven o Gradle)
    • Coloque esta tarea antes de la tarea Maven/Gradle
    • Marque la casilla "Ejecutar análisis de SonarQube" en la configuración de la tarea Maven/Gradle.
  • cli
    • Para otros casos, puede usar el analizador independiente (sonar-scanner) y establecer toda la configuración con esta tarea y, a continuación, agregar la tarea "Ejecutar análisis de código".

msBuildVersion - versión del analizador de .NET
Alias de entrada: dotnetScannerVersion. string. Opcional. Use cuando scannerMode = dotnet.

Especifique la versión del analizador de .NET que se va a usar. Las versiones se pueden encontrar aquí.


de la CLI del analizador de
Alias de entrada: cliScannerVersion. string. Opcional. Use cuando scannerMode = cli.

Especifique la versión del analizador de la CLI que se va a usar. Las versiones se pueden encontrar aquí.


modo de
string. Obligatorio cuando scannerMode = cli. Valores permitidos: file (Almacenar la configuración con mi código fuente (sonar-project.properties)), manual (proporcionar manualmente la configuración). Valor predeterminado: file.

Elija su método de configuración preferido.


archivo de configuración de
string. Opcional. Use cuando scannerMode = cli && configMode = file. Valor predeterminado: sonar-project.properties.

Puede encontrar más información aquí.


cliProjectKey - clave de proyecto
string. Obligatorio cuando scannerMode = cli && configMode = manual.

Clave única del proyecto SonarQube, es decir, sonar.projectKey.


projectKey - clave de proyecto
string. Obligatorio cuando scannerMode = dotnet.

Clave única del proyecto SonarQube, es decir, sonar.projectKey.


de nombre de proyecto de
string. Opcional. Use cuando scannerMode = cli && configMode = manual.

Nombre del proyecto SonarQube, es decir, sonar.projectName.


de nombre de proyecto de
string. Opcional. Use cuando scannerMode = dotnet.

Nombre del proyecto SonarQube, es decir, sonar.projectName.


versión del proyecto
string. Opcional. Use cuando scannerMode = cli && configMode = manual. Valor predeterminado: 1.0.

La versión del proyecto SonarQube, es decir, sonar.projectVersion.


versión del proyecto
string. Opcional. Use cuando scannerMode = dotnet. Valor predeterminado: 1.0.

La versión del proyecto SonarQube, es decir, sonar.projectVersion.


raíz del directorio orígenes de
string. Obligatorio cuando scannerMode = cli && configMode = manual. Valor predeterminado: ..

Ruta de acceso al directorio raíz que contiene archivos de origen. Este valor se establece en la propiedad sonar.sources SonarQube.


extraProperties - propiedades adicionales
string. Valor predeterminado: # Additional properties that will be passed to the scanner, \n# Put one key=value per line, example:\n# sonar.exclusions=**/*.bin.

propiedades adicionales pasar al analizador. Especifique cada par clave=valor en una nueva línea.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Nota

Las tareas sonarQube forman parte de la extensión SonarQube para Azure DevOps, que está preinstalada en Azure DevOps Services. Para obtener más información y compatibilidad con tareas de SonarQube y SonarQube, consulte extensión SonarQube para Azure DevOps, SonarQube: Visual Studio Marketplacey Sonar Community.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Agente, DeploymentGroup
demandas Ninguno
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquier
variables settable Cualquier
Versión del agente 3.218.0 o superior
Categoría de tarea Construir