리서치이노션 지식위키리서치이노션 지식위키
  • Introduction
  • 코딩 스타일 가이드

    • 공통 스타일
    • 언어별 가이드
    • 코드 품질 및 규칙
    • 코드 리뷰 & 테스트
  • Front-End

    • HTML Layout
    • Javascript
    • Library
  • Back-End

    • Spring Boot
    • eGovFrame
  • 환경 구축

    • Window
    • Linux
    • Spring Framework
  • Figma 템플릿

    • 컴포넌트 시스템
    • 웹 서비스 스타일 가이드
    • 모바일 디자인 템플릿
  • HTML/CSS 템플릿

    • 기본 부트스트랩 템플릿
    • 관리자 테마 UI
  • 기타 자료

    • 디자인 시스템 문서
    • 공통 아이콘 폴더
  • 운영 사이트

    • GitLab (버전 관리)
    • Jenkins (배포 자동화)
    • SonarQube (정적 코드 분석)
    • Send API 문서 (Postman)
  • 접속 환경

    • VPN 연결
  • Introduction
  • 코딩 스타일 가이드

    • 공통 스타일
    • 언어별 가이드
    • 코드 품질 및 규칙
    • 코드 리뷰 & 테스트
  • Front-End

    • HTML Layout
    • Javascript
    • Library
  • Back-End

    • Spring Boot
    • eGovFrame
  • 환경 구축

    • Window
    • Linux
    • Spring Framework
  • Figma 템플릿

    • 컴포넌트 시스템
    • 웹 서비스 스타일 가이드
    • 모바일 디자인 템플릿
  • HTML/CSS 템플릿

    • 기본 부트스트랩 템플릿
    • 관리자 테마 UI
  • 기타 자료

    • 디자인 시스템 문서
    • 공통 아이콘 폴더
  • 운영 사이트

    • GitLab (버전 관리)
    • Jenkins (배포 자동화)
    • SonarQube (정적 코드 분석)
    • Send API 문서 (Postman)
  • 접속 환경

    • VPN 연결
  • 운영 사이트

    • GitLab (버전 관리)

      • 1. 개요
    • Jenkins (배포 자동화)

      • 1. 개요
      • 2. 원격 서버 설정 가이드
    • SonarQube (정적 코드 분석)

      • 1. 개요
      • 2-1. 프로젝트 생성 (로컬)
      • 3-0. 분석 결과 해석 및 필수 조치 가이드
      • 3-1. 로컬 점검

🧪 SonarScanner 클라이언트 설치 및 설정 (Windows)

1️⃣ SonarScanner 다운로드

SonarScanner 클라이언트 점검을 위해 아래 파일을 다운로드합니다.

📄 SonarScanner CLI 다운로드

다운로드 후 원하는 경로에 압축을 해제합니다.
예시:

C:\sonar-scanner-7.3.0.5189-windows-x64

2️⃣ SonarScanner 환경 변수 설정

시스템 환경 변수 PATH에 <bin> 등록 후 셋팅 확인

sonar_local_1sonar_local_2

🔍 SonarScanner 버전 확인 (관리자 권한)

SonarScanner 설치가 완료된 후,
명령 프롬프트(CMD)를 관리자 권한으로 실행하여 정상 설치 여부를 확인합니다.

1️⃣ 관리자 권한으로 CMD 실행

  • Windows 검색창에서 cmd 입력
  • 명령 프롬프트 우클릭
  • 관리자 권한으로 실행 선택

2️⃣ SonarScanner 버전 확인

CMD 창에서 아래 명령어를 실행합니다.

sonar-scanner -v

아래와 같은 문구가 나오면 정상적으로 설치 완료된 것입니다.

INFO   SonarScanner CLI 7.3.0.5189

SonarQube 서버 정보 설정

  • 위치: C:\sonar-scanner-7.3.0.5189-windows-x64\conf 폴더의 sonar-scanner.properties 파일 수정
  • sonar.host.url 경로를 아래와 같이 수정
sonar.host.url=https://sonar.reinno.com

🧪 SonarScanner 설정파일 설정 (Windows)

1️⃣ SonarScanner 설정파일 다운로드

  • SonarScanner 클라이언트 점검을 위해 아래 파일을 다운로드합니다.
📄 SonarScanner 설정파일 다운로드

2️⃣ 분석할 소스 코드의 Root Folder에 파일 옮기기

  • Prjoect와 User Token은 Web(https://sonar.reinno.com)에서 생성하고 그 정보를 기입합니다.
    sonar.projectKey, sonar.projectName, sonar.login
  • C:\AAA\BBB 같은 Windows 경로 입력시, Character Escape가 발생할 수 있으므로 C:\AAA\BBB 처럼 대체(\ -> \)해서 입력합니다.
    sonar.sources, sonar.java.binaries
# 시스템 명 기입
sonar.projectKey=[Scanning Code]
# Source 위치
sonar.sources=./src
sonar.sourceEncoding=UTF-8
# Class File이 위치한 Root Directory
sonar.java.binaries=./target/classes

# 시스템 명 기입
sonar.projectName=[Scanning Code]
sonar.projectVersion=1.0
# 소나큐브에서 생성한 User Token 입력
sonar.login=[User Token]

# 점검 시 예외할 폴더 예시
sonar.exclusions=[**/src/test/**]

# JRE 자동 다운로드 완전히 끄기
sonar.scanner.skipJreProvisioning=true

🧪 SonarScanner 실행

1️⃣ 분석할 소스 코드의 Root Folder에서 SonarScanner 실행

  • Windows 검색창에서 cmd 입력
  • 명령 프롬프트 우클릭
  • 관리자 권한으로 실행 선택
  • cd 명령어를 통해 분석할 소스 코드의 Root Folder로 이동
D:
cd D:\Reinnos\git\spring-security-multi-forcelogout\demo
  • 이동된 경로에서 SonarScanner 명령어 실행
sonar-scanner
  • 아래와 같은 문구가 나오면 정상적으로 분석이 완료된 것입니다.
INFO  Scanner configuration file: C:\sonar-scanner-7.3.0.5189-windows-x64\bin\..\conf\sonar-scanner.properties
INFO  Project root configuration file: D:\Reinnos\git\spring-security-multi-forcelogout\demo\sonar-project.properties
INFO  SonarScanner CLI 7.3.0.5189
INFO  Windows 11 10.0 amd64
INFO  Communicating with SonarQube Community Build 25.12.0.117093
WARN  Use of 'sonar.login' property has been deprecated in favor of 'sonar.token' (or the env variable alternative 'SONAR_TOKEN'). Please use the latter when passing a token.
INFO  JRE provisioning is disabled
INFO  Using the java executable 'C:\sonar-scanner-7.3.0.5189-windows-x64\bin\..\jre\bin\java.exe' from JAVA_HOME
INFO  Starting SonarScanner Engine...
INFO  Java 17.0.15 Eclipse Adoptium (64-bit)
···
INFO  Analysis total time: 41.547 s
INFO  SonarScanner Engine completed successfully
INFO  EXECUTION SUCCESS
INFO  Total time: 47.157s
···
GitLab에서 이 페이지 편집하기
최종 수정일: 26. 1. 7. 오후 1:59
기여자: jhhyun@reinno.com
Prev
3-0. 분석 결과 해석 및 필수 조치 가이드