SonarQubePrepare@7 - Menyiapkan tugas Konfigurasi Analisis v7

2025-06-24

Siapkan konfigurasi analisis SonarQube.

Nota

Tugas SonarQube adalah bagian dari ekstensi SonarQube untuk Azure DevOps, yang telah diinstal sebelumnya di Azure DevOps Services. Untuk informasi dan dukungan selengkapnya untuk tugas SonarQube dan SonarQube, lihat ekstensi SonarQube untuk Azure DevOps, SonarQube - Visual Studio Marketplace, dan Sonar Community.

Sintaksis

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

Input

SonarQube - Titik Akhir Server SonarQube
string. Diperlukan.

Pilih titik akhir server SonarQube untuk proyek Anda. Untuk membuatnya, klik tautan Kelola dan buat Titik Akhir Server SonarQube baru, masukkan url dan token server Anda.

scannerMode - Pilih cara menjalankan analisis
string. Diperlukan. Nilai yang diizinkan: dotnet (Integrasikan dengan .NET), cli (Gunakan SonarScanner CLI mandiri), other (Integrasikan dengan Maven atau Gradle). Nilai default: dotnet.

dotnet (Integrasikan dengan .NET)
- Letakkan tugas ini sebelum tugas build Anda
- Tambahkan tugas 'Jalankan Analisis Kode' setelah tugas MSBuild/VSTest
other (Integrasikan dengan Maven atau Gradle)
- Letakkan tugas ini sebelum tugas Maven/Gradle
- Centang kotak centang 'Jalankan Analisis SonarQube' di konfigurasi tugas Maven/Gradle.
cli
- Untuk kasus lain, Anda dapat menggunakan pemindai mandiri (sonar-scanner) dan mengatur semua konfigurasi dengan tugas ini, lalu menambahkan tugas 'Jalankan Analisis Kode'.

msBuildVersion - Versi Pemindai .NET
Alias input: dotnetScannerVersion. string. Fakultatif. Gunakan saat scannerMode = dotnet.

Tentukan versi Pemindai .NET yang akan digunakan. Versi dapat ditemukan di sini.

Versi CLI Pemindai
Alias input: cliScannerVersion. string. Fakultatif. Gunakan saat scannerMode = cli.

Tentukan versi pemindai CLI yang akan digunakan. Versi dapat ditemukan di sini.

Mode
string. Diperlukan saat scannerMode = cli. Nilai yang diizinkan: file (Simpan konfigurasi dengan kode sumber saya (sonar-project.properties)), manual (Menyediakan konfigurasi secara manual). Nilai default: file.

Pilih metode konfigurasi pilihan Anda.

File Pengaturan
string. Fakultatif. Gunakan saat scannerMode = cli && configMode = file. Nilai default: sonar-project.properties.

Informasi selengkapnya tersedia di sini.

Kunci Proyek
string. Diperlukan saat scannerMode = cli && configMode = manual.

Kunci unik proyek SonarQube, yaitu sonar.projectKey.

Kunci Proyek
string. Diperlukan saat scannerMode = dotnet.

Kunci unik proyek SonarQube, yaitu sonar.projectKey.

Nama Proyek
string. Fakultatif. Gunakan saat scannerMode = cli && configMode = manual.

Nama proyek SonarQube, yaitu sonar.projectName.

Nama Proyek
string. Fakultatif. Gunakan saat scannerMode = dotnet.

Nama proyek SonarQube, yaitu sonar.projectName.

cliProjectVersion - Versi Project
string. Fakultatif. Gunakan saat scannerMode = cli && configMode = manual. Nilai default: 1.0.

Versi proyek SonarQube, yaitu sonar.projectVersion.

projectVersion - Versi Project
string. Fakultatif. Gunakan saat scannerMode = dotnet. Nilai default: 1.0.

Versi proyek SonarQube, yaitu sonar.projectVersion.

akar direktori Sumber
string. Diperlukan saat scannerMode = cli && configMode = manual. Nilai default: ..

Jalur ke direktori akar yang berisi file sumber. Nilai ini diatur ke properti sonar.sources SonarQube.

extraProperties - Properti Tambahan
string. Nilai default: # Additional properties that will be passed to the scanner, \n# Put one key=value per line, example:\n# sonar.exclusions=**/*.bin.

Properti tambahan untuk diteruskan ke pemindai. Tentukan setiap pasangan key=value pada baris baru.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak.

Komentar

Nota

Persyaratan

Syarat	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah	Apa pun
variabel yang Dapat Diatur	Apa pun
Versi agen	3.218.0 atau lebih tinggi
Kategori tugas	Membangun