기능

SonarQube Scanner for Gradle를 사용하면 손쉽게 Gradle 프로젝트를 분석할 수 있습니다.

일반적인 Gradle task에서 SonarQube 분석을 수행할 수 있기 때문에, gradle을 사용할 수 있는 모든 환경(개발 빌드, CI server 등)에서 별도의 수작업(다운로드, 셋업, SonarQube Scanner 설치 등) 없이 분석이 가능합니다. Gradle 빌드에서 생성되는 정보들로 SonarQube 분석을 수행하기에 충분합니다. 해당 정보들을 기반으로 분석을 위한 설정 작업을 수행하기 때문에, 수작업을 통한 환경 설정이 현저하게 줄어듭니다.

호환성

SonarQube Scanner for Gradle v2.x는 Gradle v1.12+ 및 SonarQube v5.6+과 호환됩니다.

Java 프로젝트 및 Android 프로젝트를 분석하는 경우, javac로 컴파일 된 바이트코드가 필요합니다.

사전 조건

• SonarQube 서버를 설치합니다.
• SonarQube 서버가 사용할 Java 버전을 하나 이상 설치합니다.
• 분석 언어 플러그인을 설치합니다.
• 소스 코드 분석하기를 숙지합니다.

스캐너 설정

설치는 자동 수행되지만, 몇가지 글로벌 속성은 사용자가 직접 설정해야 합니다. 글로벌 속성은  ~/.gradle/gradle.properties에서 설정할 수 있습니다. 모든 속성은 System 속성이므로, systemProp prefix를 사용해야 합니다.

systemProp.sonar.host.url=http://localhost:9000
 
#----- Security (when 'sonar.forceAuthentication' is set to 'true')
systemProp.sonar.login=<token>

분석

1 - 빌드에서 스캐너 활성화

Gradle 2.1+:

plugins {
  id "org.sonarqube" version "2.6"
}

보다 자세한 내용은 https://plugins.gradle.org/plugin/org.sonarqube를 참조합니다.

로컬 SonarQube 서버가 정상적으로 설치되고 실행된 상태라고 가정합니다. 별도로 추가 설정을 할 필요는 없습니다.

2 - 분석 실행

gradle sonarqube 명령어를 실행합니다. 분석이 완료되면 로그 하단에 표시되는 웹페이지에서 결과를 확인할 수 있습니다. 별도의 작업이 분석 결과를 정상 확인할 수 있어야 합니다.

분석 속성 설정하기

SonarQube Scanner for Gradle은 Gradle의 객체 모델에 포함된 정보를 활용해 SonarQube 표준 속성을 설정합니다. 기본 속값은 아래 테이블에 표시되어 있습니다.

표준 SonarQube 속성 Gradle 기본값

sonar.projectKey

sonar.projectName

${project.name}

sonar.projectDescription

${project.description}

sonar.projectVersion

${project.version}

sonar.projectBaseDir

${project.projectDir}

sonar.working.directory

${project.buildDir}/sonar

추가 속성의 기본값은 java-base 혹은 java 플러그인이 적용된 프로젝트에 한해 제공합니다:

Java 프로젝트에 대한 추가 속성의 Gradle 기본값

sonar.sourceEncoding

${project.compileJava.options.encoding}

sonar.java.source

${project.sourceCompatibility}

sonar.java.target

${project.targetCompatibility}

sonar.sources

sonar.tests

sonar.java.binaries

${sourceSets.main.output.classesDir}

sonar.java.libraries

sonar.java.test.binaries

sonar.java.test.libraries

sonar.junit.reportPaths

Groovy 프로젝트에 대한 추가 속성의 Gradle 기본값

Java 프로젝트의 추가 속성에 다음 속성이 추가됩니다:

sonar.groovy.binaries

JaCoCo 플러그인 적용시, 추가 속성의 Gradle 기본값

Android 프로젝트에 대한 추가 속성의 Gradle 기본값
(com.android.application, com.android.library 혹은 com.android.test)

기본적으로 "debug" 타입의 첫 번쨔 variant를 활용해 분석 환경을 설정합니다. variant를 지정하고자 하는 경우, androidVariant 파라미터를 사용합니다:

sonarqube {
    androidVariant 'fullDebug'
}

수동으로 속성 파라미터 및 속성값 설정하기

Gradle 프로젝트 및 하위프로젝트에 SonrQubeExtention 확장어를 추가해 분석 파라미터를 설정/오버라이딩 할 수 있습니다:

sonarqube {
    properties {
        property "sonar.exclusions", "**/*Generated.java"
    }
}

속성 파라미터 및 속성값은 커맨드 라인에서도 입력할 수 있습니다. 더 자세한 정보는 "Configuring properties from the command line"를 참조합니다.

멀티 프로젝트 빌드 분석하기

계층구조를 가진 프로젝트를 분석하고자 하는 경우, SonarQube 플러그인은 해당 계층의 루트 프로젝트에 적용해야합니다. 일반적으로(꼭 그런것은 아니지만), 이 위치가 Gradle 빌드의 루트 프로젝트가 됩니다. 분석을 위해 전달하는 모든 정보는 sonarqube 블록에서 설정합니다. 커맨드 라인에서 입력한 모든 속성들도 이 프로젝트에 적용됩니다:

Global configuration 설정

sonarqube {
    properties {
        property "sonar.sourceEncoding", "UTF-8"
    }
}

Shared configuration 설정

하위 프로젝트들이 공유하는 설정은 subprojects 블럭에 정의합니다:

subprojects {
    sonarqube {
        properties {
            property "sonar.sources", "src"
        }
    }
}

Individual configuration 설정

특정 프로젝트 범위로 제한되는 설정은 해당 프로젝트의 sonarqube 블록에서 정의합니다:

project(":project1") {
    sonarqube {
        properties {
            property "sonar.branch", "Foo"
        }
    }}

특정 프로젝트를 분석에서 제외하기

특정 프로젝트를 분석 대상에서 제외하고자 하는 경우, sonarqube.skipProject 값을 true로 설정합니다:

project(":project2") {
    sonarqube {
        skipProject = true
    }
}

커스텀 소스 셋 분석하기

기본적으로 SonarQube Scanner for Gradle은 분석 대상 프로젝트의 디렉토리 레이아웃과 관계없이 main source set을 프로덕션 소스로, test source set을 테스트 소스로 전달합니다. 추가 source set 설정이 필요한 경우 아래와 같이 설정합니다.

Analyzing custom source set

sonarqube {
    properties {
        properties["sonar.sources"] += sourceSets.custom.allSource.srcDirs
        properties["sonar.tests"] += sourceSets.integTest.allSource.srcDirs
    }
}

SonarQube 속성 설정

sonarqube.properties {} 블록을 조금 더 살펴보도록 하겠습니다. 예제에서 이미 본 바와 같이 property() 메소드를 사용해 새로운 속성을 설정하거나, 기존 속성을 오버라이딩할 수 있습니다. 또한 Gradle에 의해 사전 설정된 속성들을 포함해 이 시점까지 설정된 모든 속성들은 properties 접근자를 통해 사용할 수 있습니다. properties map의 엔트리들은 일반적인 Groovy 문법을 사용해 읽어들이거나 덮어쓸 수 있습니다. 편리한 데이터 조작을 위해 각 값들은 "idiomatic" 타입(File, List, 등)을 가집니다. sonarProperties 블록을 확인한 후, 각 값들은 다음과 같이 String으로 변경됩니다:

• Collection values → Comma-seperated Strings
• Other values → Strings

 Gradle의 객체 모델의 속성들을 사용하는 데 문제가 없도록, sonarProperties 블록에 대한 확인 작업은 가능한 늦은 시점에(lazily) 수행됩니다.

Command Line을 통한 속성 설정

커맨드 라인 명령어의 인자로 SonarQube 속성값을 동일하게 사용해 SonarQube 속성을 설정할 수 있습니다. 민감한 정보(예를 들면 credential 등)나 환경 정보 혹은 일시적인 설정을 해야할 경우 유용하게 사용할 수 있습니다.

gradle sonarqube -Dsonar.host.url=http://sonar.mycompany.com -Dsonar.verbose=true

위와 같은 방법이 때로 유용할 수 있으나, 가급적이면 속성 정보는 (버전 관리된) 빌드 스크립트에 저장해서 모든 사람들이 잘 알 수 있도록 하는 것을 권장합니다.

시스템 속성을 통해 설정된 하나의  SonarQube 속성 값은 빌드 스크립트의 값을 오버라이드합니다. 계층 구조를 가진 프로젝트를 분석하는 경우, 시스템 속성을 통해 설정된 SonarQube 속성 값들은 계층 구조의 root에 반영됩니다. "sonar."로 시작하는 모든 속성이 이에 해당합니다.

태스크 의존성

sonarqube 태스크를 실행하기 전 SonarQube 분석에 필요한 산출물을 생성하는 모든 태스크들을 실행해야 합니다. 일반적으로 compile 태스크, test 태스크 및 code coverage 태스크들이 이에 포함됩니다. 이와 같은 실행을 보장하기 위해 java 플러그인이 적용되는 경우 sonarqube 태스크로부터 test 태스크에 대해 의존성을 설정할 수 있습니다. 아래의 예와 같이 필요한 만큼 의존성을 설정할 수 있습니다:

project.tasks["sonarqube"].dependsOn "anotherTask"

예제

실제로 동작하는 간단한 예제 소스 코드를 아래에서 다운로드 하실 수 있습니다. 여러분의 환경에 맞춰 필요한 설정을 변경해 사용해 보십시오: https://github.com/SonarSource/sonar-scanning-examples/tree/master/sonarqube-scanner-gradle