SW/Gradle

Gradle: Sonar 제대로 활용하는 법! 이 업데이트, 개발자라면 놓치면 안 돼요!

얇은생각 2025. 3. 2. 07:30
반응형

Gradle Sonar가 바뀌었다고? 무슨 일이야?

개발을 하다 보면 새롭게 바뀌는 툴이나 기능을 따라가는 게 참 쉽지 않죠. 이번에도 중요한 변화가 하나 생겼는데요, Gradle 기반 프로젝트에서 SonarQube 대신 이제는 Sonar로 통합됐어요! 그리고 인증 토큰을 입력하는 방식도 살짝 바뀌었답니다.

이게 뭐가 그렇게 중요한지 궁금하죠? 걱정 마세요. 쉽게 풀어서 설명해 드릴게요. 개발 환경을 최신 상태로 유지하면서 코드 품질을 한층 끌어올릴 수 있는 꿀팁도 함께 알려드릴게요!

 

Gradle: Sonar 제대로 활용하는 법! 이 업데이트, 개발자라면 놓치면 안 돼요!

 

Sonar, 이 친구 왜 이렇게 난리야?

Sonar는 한 마디로 개발자의 든든한 조력자예요. 코드를 자동으로 분석해서 버그, 보안 취약점, 코드 냄새(Code Smells) 같은 문제를 찾아내죠. 마치 코드 건강 검진을 해주는 도구라고 보면 돼요.

예전에는 SonarQube라는 이름이었는데 이제 그냥 Sonar라고 부르면 됩니다. 뭔가 더 직관적이고 깔끔해졌죠? Gradle과의 연동도 훨씬 편리해졌고, 설정하는 과정도 간단해졌어요. 이번 업데이트는 솔직히 반가운 변화예요!

 

핵심 포인트만 쏙쏙 정리!

1. SonarQube 대신 Sonar 사용!

이전에는 이렇게 실행했어요:

./gradlew sonarQube

 

이제는 더 간단하게!

./gradlew sonar

 

짧고 이해하기 쉬워졌죠? 앞으로는 그냥 Sonar라고 부르면 돼요!

 

2. 인증 방식 변경: 더 편리하고 안전하게!

토큰을 입력하는 방법도 바뀌었어요.

 

이전 방식 (이제 안 씁니다)

./gradlew sonar -Dsonar.login=<your-token>

 

매번 토큰을 입력하는 건 번거롭기도 하고, 보안상으로도 별로였어요.

 

새로운 방식 (추천하는 방법!)

이제는 build.gradle 파일에 토큰을 등록하면 끝이에요.

sonarqube {
    properties {
        property "sonar.token", "<your-generated-token>"
    }
}

 

여기서 <your-generated-token> 부분을 Sonar 대시보드에서 생성한 토큰으로 바꾸면 됩니다. 이제 매번 입력할 필요 없이 자동으로 인증됩니다. 깔끔하고 편리하죠?

 

어떻게 적용하면 될까? (단계별 가이드)

1단계: Sonar 토큰 만들기

  1. Sonar 대시보드에 접속하세요.
  2. My Account > Security로 가서 새 토큰을 생성하세요.
  3. 생성된 토큰을 복사하세요. (다시 볼 수 없으니 꼭 저장해 두세요!)

 

2단계: build.gradle 파일 수정

sonarqube {
    properties {
        property "sonar.token", "<your-generated-token>"
    }
}

 

이제 Sonar 실행할 때 자동으로 인증이 됩니다.

 

3단계: 코드 품질 분석 실행!

./gradlew sonar

 

이제 이 명령어만 실행하면 끝! Sonar가 코드를 분석하고 품질 보고서를 만들어줍니다. 신기하죠?

 

이 업데이트, 왜 중요할까요?

1. 보안 강화

이전 방식처럼 토큰을 명령어에 직접 입력하지 않으니, 노출 위험이 줄어들어요. 개발할 때 보안은 필수잖아요!

 

2. 더 편한 개발 환경

이제 매번 토큰을 입력할 필요가 없어요. 한 번만 설정하면 이후엔 신경 쓸 필요 없으니 얼마나 편한지 몰라요.

 

3. 최신 환경에 맞춰 유지보수 편리!

Gradle과 Sonar의 변화에 맞춰 설정을 바꿔두면 앞으로도 업데이트 대응이 훨씬 쉬워질 거예요.

 

자주 하는 실수 & 해결 방법

1. 토큰 인증이 안 돼요!

✅ 토큰이 정확한지 확인하세요. ✅ 토큰이 만료됐다면 새로 생성해서 다시 설정하세요.

 

2. sonar 명령어가 안 먹어요!

✅ build.gradle에 Sonar 플러그인이 추가되어 있는지 확인하세요:

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

 

3. Gradle 빌드가 실패해요!

✅ Gradle 설정에서 SonarQube 플러그인이 빠졌다면 추가하세요:

dependencies {
    classpath "org.sonarsource.scanner.gradle:sonarqube-gradle-plugin:4.0.0"
}

 

그리고 build.gradle에서 적용하세요:

apply plugin: 'org.sonarqube'

 

마무리: Sonar로 코드 품질 한 단계 업그레이드!

솔직히, 이번 업데이트는 정말 반가운 변화예요. 코드 품질을 쉽게 관리하면서 보안까지 챙길 수 있는 좋은 기회니까요. Sonar를 활용하면 코드의 문제점을 빠르게 찾아서 수정할 수 있으니, 꼭 적용해 보세요!

반응형