Condividi tramite

SonarQubePrepare@7 - Preparare l'attività Configurazione analisi v7

  • Articolo

Preparare la configurazione dell'analisi SonarQube.

Nota

Le attività SonarQube fanno parte dell'estensione SonarQube per Azure DevOps, preinstallata in Azure DevOps Services. Per altre informazioni e supporto per le attività SonarQube e SonarQube, vedere 'estensione SonarQube per Azure DevOps, SonarQube - Visual Studio Marketplacee Sonar Community.

Sintassi

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

Ingressi

SonarQube - dell'endpoint server SonarQube
string. Obbligatorio.

Selezionare l'endpoint server SonarQube per il progetto. Per crearne uno, fare clic sul collegamento Gestisci e creare un nuovo endpoint server SonarQube, immettere l'URL e il token del server.


scannerMode - Scegliere la modalità di esecuzione dell'analisi
string. Obbligatorio. Valori consentiti: dotnet (integrazione con .NET), cli (usare l'interfaccia della riga di comando autonoma di SonarScanner), other (integrazione con Maven o Gradle). Valore predefinito: dotnet.

  • dotnet (integrazione con .NET)
    • Inserire questa attività prima dell'attività di compilazione
    • Aggiungere l'attività 'Esegui analisi del codice' dopo le attività MSBuild/VSTest
  • other (integrazione con Maven o Gradle)
    • Inserire questa attività prima dell'attività Maven/Gradle
    • Selezionare la casella di controllo "Esegui SonarQube Analysis" nella configurazione dell'attività Maven/Gradle.
  • cli
    • Per altri casi è possibile usare lo scanner autonomo (sonar-scanner) e impostare tutta la configurazione con questa attività, quindi aggiungere l'attività "Esegui analisi codice".

msBuildVersion - versione dello scanner .NET
Alias di input: dotnetScannerVersion. string. Opzionale. Usare quando scannerMode = dotnet.

Specificare la versione dello scanner .NET da usare. Le versioni possono trovarsi qui.


versione dell'interfaccia della riga di comando dello scanner
Alias di input: cliScannerVersion. string. Opzionale. Usare quando scannerMode = cli.

Specificare la versione dello scanner dell'interfaccia della riga di comando da usare. Le versioni possono trovarsi qui.


modalità
string. Obbligatorio quando scannerMode = cli. Valori consentiti: file (configurazione dello Store con il codice sorgente (sonar-project.properties)), manual (specificare manualmente la configurazione). Valore predefinito: file.

Scegliere il metodo di configurazione preferito.


configFile - file di impostazioni
string. Opzionale. Usare quando scannerMode = cli && configMode = file. Valore predefinito: sonar-project.properties.

Altre informazioni sono disponibili qui.


cliProjectKey - chiave del progetto
string. Obbligatorio quando scannerMode = cli && configMode = manual.

Chiave univoca del progetto SonarQube, ad esempio sonar.projectKey.


projectKey - chiave del progetto
string. Obbligatorio quando scannerMode = dotnet.

Chiave univoca del progetto SonarQube, ad esempio sonar.projectKey.


cliProjectName - nome progetto
string. Opzionale. Usare quando scannerMode = cli && configMode = manual.

Nome del progetto SonarQube, ad esempio sonar.projectName.


projectName - nome progetto
string. Opzionale. Usare quando scannerMode = dotnet.

Nome del progetto SonarQube, ad esempio sonar.projectName.


cliProjectVersion - versione del progetto
string. Opzionale. Usare quando scannerMode = cli && configMode = manual. Valore predefinito: 1.0.

Versione del progetto SonarQube, ad esempio sonar.projectVersion.


projectVersion - versione del progetto
string. Opzionale. Usare quando scannerMode = dotnet. Valore predefinito: 1.0.

Versione del progetto SonarQube, ad esempio sonar.projectVersion.


cliSources - Sources directory root
string. Obbligatorio quando scannerMode = cli && configMode = manual. Valore predefinito: ..

Percorso della directory radice contenente i file di origine. Questo valore viene impostato sulla proprietà sonar.sources SonarQube.


extraProperties - proprietà aggiuntive
string. Valore predefinito: # Additional properties that will be passed to the scanner, \n# Put one key=value per line, example:\n# sonar.exclusions=**/*.bin.

Proprietà aggiuntive da passare allo scanner. Specificare ogni coppia chiave=valore in una nuova riga.


Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Nota

Le attività SonarQube fanno parte dell'estensione SonarQube per Azure DevOps, preinstallata in Azure DevOps Services. Per altre informazioni e supporto per le attività SonarQube e SonarQube, vedere 'estensione SonarQube per Azure DevOps, SonarQube - Visual Studio Marketplacee Sonar Community.

Fabbisogno

Requisito Descrizione
Tipi di pipeline YAML, build classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 3.218.0 o versione successiva
Categoria attività Costruire