이 문서는 Jira에서 SonarQube Connector 애드온을 사용하여 Jira Software에서 SonarQube의 분석된 결과를 확인하는 기능에 대한 정보를 공유한다.
| 목차 |
|---|
SonarQube Connector 설치
전역 설정 구성
Manage apps - SonarQube Connector 클릭
정보 입력
SonarQube 서버 URL: SonarQube 설치를 위한 서버 기본 URL.
Token: 선택 사항. SonarQube 인스턴스가 공용이 아닌 경우 SonarQube 사용자의 보안 토큰으로 이 필드를 설정해야 한다. 토큰 유형은 USER 토큰 유형이어야 한다.
프로젝트 설정 구성
Connection settings (전역 설정 구성 시 자동 세팅)
SonarQube 서버 URL: SonarQube 설치를 위한 서버 기본 URL.
Token: 선택 사항. SonarQube 인스턴스가 공용이 아닌 경우 SonarQube 사용자의 보안 토큰으로 이 필드를 설정해야 한다. 토큰 유형은 USER 토큰 유형이어야 한다.
Report settings
Resource ID: 필수 입력, 품질 메트릭을 검색할 SonarQube 리소스의 키. 이 키는 SonarQube 프로젝트 대시보드 또는 SonarQube 프로젝트 분석 파라미터에서 가져올 수 있다.
참고1: 버전 1.4부터 쉼표로 구분된 리소스 키 목록을 제공하여 둘 이상의 리소스/프로젝트 키를 설정할 수 있다. 측정값은 모든 프로젝트에 대한 고유한 보기로 집계된다. 여러 프로젝트를 Jira에 연결 섹션을 참조.
- 참고2 : Enterprise Edition의 경우 포트폴리오 키를 리소스로 사용할 수 있으며 해당 포트폴리오에 관련된 프로젝트들은 자동적으로 나타난다.
Tags:선택 필드. SonarQube / SonarCloud에서 프로젝트와 관련된 태그를 통해 프로젝트를 가져올 수 있다. 이러한 태그는 SonarQube/SonarCloud의 프로젝트 페이지 또는 분석 속성에서 얻을 수 있다. 쉼표로 구분된 태그 목록을 지정하여 둘 이상의 태그를 구성할 수 있다. 결과는 모든 리소스가 함께 있는 단일 보기로 집계된다.
Issue type: SonarQube에 이슈를 생성하기 위한 기본 이슈 타입
Custom metrics: 대시보드에 표시할 사용자 지정 메트릭 키 목록으로, 1 또는 쉼표로 구분된 메트릭 키 목록을 지정할 수 있다. 예: blocker_violations, major_violations, classes.
Jira Issue Type settings
- SonarQube 이슈에 대한 Jira 이슈 생성 시 사용할 이슈 타입을 설정할 수 있다.
SonarQube 프로젝트 분석 결과 확인
Jira 프로젝트 왼쪽 메뉴의 SonarQube Connector를 클릭하여 확인할 수 있다.
- Overview
해당 SonarQube 프로젝트의 Quality Gate 결과와 발견된 이슈 정보를 확인할 수 있다.
- PDF 다운로드
오른쪽 상단 "Download PDF" 버튼 클릭
분석 결과를 PDF로 확인할 수 있다.
- SonarQube 이슈 기반으로 Jira 이슈 생성
각 이슈에서 "+"버튼을 클릭하여 Jira 이슈를 생성할 수 있다.
SonarQube의 이슈에 대한 설명과 SonarQube페이지 연결 링크가 자동으로 생성되는 것을 확인할 수 있다.
