Gradle: SonarQube 설치부터 실행 방법, 예제, 가이드

혹시 코드 품질 관리가 어렵다고 느껴본 적 있나요? 버그가 자꾸 생기고, 코드가 엉망처럼 보인다면 SonarQube가 딱입니다. 이 강력한 도구는 코드의 문제점을 잡아주고, 보안 취약점도 찾아내며, 유지보수를 훨씬 쉽게 만들어줘요. 이번 가이드에서는 SonarQube를 다운로드하고 실행하는 방법을 하나하나 친절하게 설명해 드릴게요!

 

Gradle: SonarQube 설치부터 실행 방법, 예제, 가이드

 

SonarQube가 뭐야?

쉽게 말해서, SonarQube는 코드 분석 도구예요. 다양한 프로그래밍 언어를 지원하고, CI/CD 파이프라인과도 잘 어울려요. SonarQube를 사용하면 이런 장점이 있어요:

• 코드의 문제점을 미리 찾아서 수정 가능
• 보안 취약점을 미리 발견해 해킹 위험 감소
• 코드가 더 깔끔해지고 유지보수가 쉬워짐
• 상세한 코드 품질 리포트를 제공
• 다양한 IDE 및 DevOps 도구와 연동 가능

 

설치 전에 준비해야 할 것들

SonarQube를 설치하기 전에, 아래 사항을 꼭 체크하세요:

• Java 11 이상 버전이 설치되어 있어야 함 (이거 없으면 안 돌아가요)
• 최소 2GB RAM 필요 (적어도 이 정도는 있어야 원활하게 실행됨)
• PostgreSQL, MySQL 또는 Oracle DB (프로덕션 환경에서는 필수)

 

SonarQube 설치 방법

1. SonarQube 다운로드

1. 웹 브라우저를 열고 SonarQube 다운로드를 검색하세요.
2. 공식 다운로드 페이지로 이동합니다.
3. 무료 버전인 커뮤니티 에디션을 다운로드하세요.
4. 다운로드한 파일을 원하는 폴더에 압축 해제합니다.

 

2. SonarQube 폴더 탐색 및 실행 준비

압축을 풀면 여러 폴더가 나와요. 여기서 제일 중요한 건 bin 폴더예요. 이 안에 운영 체제별 실행 파일이 들어있어요.

 

운영 체제별 SonarQube 실행법

Windows에서 실행하는 방법

1. SonarQube가 있는 폴더에서 bin 폴더로 이동합니다.
2. windows 폴더를 엽니다.
3. StartSonar.bat 파일을 실행하세요.
4. 어디서든 실행할 수 있도록 환경 변수에 Windows bin 경로를 추가하면 좋아요.
5. **명령 프롬프트(CMD)**를 열고 다음 명령어 입력: sonar start
6. sonar start
7. SonarQube가 제대로 실행됐는지 확인하세요!

 

macOS에서 실행하는 방법

1. 터미널을 열고 SonarQube bin 폴더로 이동합니다:

   cd path_to_sonarqube/bin
   

2. macOS 전용 디렉터리로 이동:

   cd macosx-universal-64
   

3. 실행 스크립트 실행:

   ./sonar.sh start
   

4. 보안 관련 오류가 뜨면 시스템 환경설정 > 보안 및 개인정보 보호에서 허용 후 다시 실행하세요.
5. 브라우저에서 localhost:9000을 열어 실행 여부를 확인하세요.

 

Linux에서 실행하는 방법

1. 터미널에서 SonarQube bin 폴더로 이동:

   cd path_to_sonarqube/bin/linux-x86-64
   

2. SonarQube 시작 명령어 실행:

   ./sonar.sh start
   

3. localhost:9000으로 들어가서 잘 실행되는지 확인하세요.

 

SonarQube 대시보드 접속 방법

1. 웹 브라우저를 열고 다음 주소를 입력하세요:

   http://localhost:9000
   

2. 로그인 버튼 클릭!
3. 기본 로그인 정보:

   아이디: admin
   비밀번호: admin
   

4. 로그인 후 대시보드 확인 🎉

 

자주 발생하는 문제 해결법

1. SonarQube가 실행되지 않아요! 😱

해결 방법:

• Java 11 이상이 설치돼 있는지 확인하세요.
• 시스템 로그를 확인해서 에러 메시지가 있는지 살펴보세요:

  tail -f logs/sonar.log
  

• 9000번 포트가 다른 프로그램에서 사용 중인지 체크하세요.
• 관리자 권한으로 실행하면 해결될 수도 있어요.

 

2. 보안 문제로 실행이 차단돼요! 😩

해결 방법:

• macOS라면 시스템 환경설정 > 보안 및 개인정보 보호에서 실행 허용.
• Windows라면 방화벽이나 백신 프로그램이 SonarQube를 막고 있는지 확인하세요.

 

마무리하며

여기까지 따라오셨다면, 이제 SonarQube를 설치하고 실행할 수 있어요! 😊

이제 코드 품질을 분석하는 데 어려움을 겪지 않아도 됩니다. 프로젝트의 코드가 깨끗해지고, 버그도 줄어들 거예요. 개발하면서 코드의 상태를 바로바로 체크할 수 있으니 너무 편해요.

다음엔 SonarQube를 Jenkins, GitHub Actions, GitLab CI/CD와 연결하는 방법도 다뤄볼 예정이에요. 기대해 주세요! 🚀