sonar quality gate

Kode Gerbang Kualitas Sonar

Sonarquce memiliki gerbang kode kualitas fitur, tetapi tidak berfungsi untuk edisi komunitas. Jadi, plugin ini akan menjadi intergate ke CI/CD, mendapatkan kode kualitas dan mendorong laporan untuk menggabungkan permintaan ketika telah berubah.

Gerbang Kualitas adalah antarmuka baris perintah untuk gerbang kode kualitas.

• Kode Analisis: Gunakan Command sonar-scanner untuk Kode Analisis, Laporkan dan Dorong Masalah ke Server Sonar.
• Dorong Masalah ke Kode Perubahan Permintaan Gabungan
• Hasilkan Kode Kualitas Laporan Kode Baru, dan Buat Catatan untuk Permintaan Gabungan.

Untuk github dan gitlab

Hasil:

Memulai

$ npm install -g sonar-quality-gate
# Show help
$ quality-gate --help

Hasil:

   __ _   _   _    __ _  | | (_) | | _   _   _            __ _    __ _  | | _    ___
  / _ ` | | | | |  / _ ` | | | | | | __ | | | | |  _____   / _ ` |  / _ ` | | __ |  / _ 
 | (_ | | | | _ | | | (_ | | | | | | | | _  | | _ | | | _____ | | (_ | | | (_ | | | | _  |  __/
  _ _, |  _ _,_ |  _ _,_ | | _ | | _ |  _ _ |  _ _, |          _ _, |  _ _,_ |  _ _ |  _ __ |
     | _ |                                | ___/           | ___/
Usage: quality-gate [options]

Global Options:
  -h, --help                                                                                                   [boolean]
  -D, --define   Define sonar property

                 Authentication:
                 sonar.login The authentication token or login of a SonarQube user with Execute Analysis permission on
                 the project.
                 More parameters:
                 - https://docs.sonarqube.org/latest/analysis/analysis-parameters/                               [array]
      --git      Config git
                 --git.url Git server URL. Default: $GIT_URL
                 --git.token Git token. Default: $GIT_TOKEN
                 --git.project_id Gitlab project ID or Github repository. Default: $CI_PROJECt_ID or $GITHUB_REPOSITORY
                 --git.merge_id Git merge request IID. Default: $CI_MERGE_REQUEST_IID
                                                                                                           [default: {}]
      --sonar    Config sonar
                 --sonar.url Sonarqube server URL. Default: $SONAR_URL or sonar.host.url in file
                 sonar-project.properties.
                 --sonar.token The authentication token of a SonarQube user with Execute Analysis permission on the
                 project. Default: $SONAR_TOKEN
                 --sonar.project_key Sonar project key. Default: sonar.projectKey in file sonar-project.properties
                                                                                                           [default: {}]
  -v, --version  Show version                                                                                  [boolean]
  -X, --debug    Produce execution debug output                                               [boolean] [default: false]
  -p, --provide                                                                                      [default: " gitlab " ]

Untuk menjalankan gerbang kode kualitas:

quality-gate -p=github -D sonar.login= " <token> " --sonar.url= " <sonar url> " --sonar.token= " <sonar token> " --sonar.project_key= " <sonar token> " --git.url= " https://gitlab.com " --git.token= " xxx " --git.project_id=123 --git.merge_id=345

Jika Set ENV untuk parameter Bellow:

GIT_URL= " "
GIT_TOKEN= " "
CI_PROJECt_ID= " "
CI_MERGE_REQUEST_IID= " "

SONAR_URL= " "
SONAR_TOKEN= " "

dan memiliki file sonar-project.properties :

 sonar.host.url=
sonar.projectKey=

Kita dapat menggunakan perintah pendek:

quality-gate -Dsonar.login= " " 

Config CI/CD

Tambahkan Sonar-Project.Properties

Tambahkan file baru sonar-project.properties seperti konten di bawah ini:

 # sonar.organization=dieuhd # if use sonarcloud, uncomment this line
sonar.host.url=[SONAR_HOST]
sonar.projectKey=[SONAR_PROJECT_KEY]
sonar.qualitygate.wait=true

Ref: sonar-project.properties

Jalankan dengan gitlab-ci

Gunakan quality-gate alih-alih sonar-scanner .

Contoh:

quality-gate -Dsonar.login= $SONAR_KEY

Dan konfigurasi untuk gitlab-ci:

 stages :
  - CheckSonar

.CheckSonarqube : &CheckSonarqube |
  quality-gate -Dsonar.login=$SONAR_KEY

Sonar :
  stage : CheckSonar
  image : dieuhd/sonar-quality-gate
  rules :
    - if : ' $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "master" '
  script :
    - *CheckSonarqube

P/S: Hanya bekerja untuk permintaan gabungan. Karena, plugin membutuhkan permintaan gabungan IID.

Jalankan dengan aksi github

Contoh:

 name : Check sonarqube
on : [pull_request]
jobs :
  build :
    name : Build
    runs-on : ubuntu-latest
    steps :
      - name : Checkout
        uses : actions/[email protected]
        with :
          fetch-depth : 0  # Shallow clones should be disabled for a better relevancy of analysis
      - name : Set up Sonar Quality Gate
        uses : dieuhd/sonar-quality-gate@v1
        env :
          GITHUB_TOKEN : ${{ secrets.GITHUB_TOKEN }} 
          GIT_URL : " https://api.github.com "
          GIT_TOKEN : ${{ secrets.GIT_TOKEN }} 
          SONAR_URL : ${{ secrets.SONAR_URL }}
          SONAR_TOKEN : ${{ secrets.SONAR_TOKEN }}
          SONAR_PROJECT_KEY : ${{ secrets.SONAR_PROJECT_KEY }}
        with :
          login :  ${{ secrets.SONAR_TOKEN }}
          url : ${{ secrets.SONAR_URL }}
          projectKey : ${{ secrets.SONAR_PROJECT_KEY }} 

Menyumbang

$ git clone https://github.com/dieuhd/sonar-quality-gate.git
$ cd sonar-quality-gate
$ npm install
$ husky install && chmod ug+x .husky/ *
$ npm run start:dev

Lisensi

Mit. Lihat lisensi.txt.