SQ Official Doc Link: https://docs.sonarqube.org/display/SONAR/Background+Tasks
다음은 백그라운드 태스트(Background Task)가 될 수 있습니다:
- Analysys Report 임포트
- Views 계산 실행
분석 보고서
분석은 관련 Background Task 종료 후 완료됩니다. SonarQube Scanner의 로그에서 EXECUTION SUCCESS가 표시되더라도, 분석 결과는 Background Task가 종료된 이후 SonarQube UI에 표시됩니다.
SonarQube Scanner가 코드 분석을 완료한 뒤, 분석 결과(소스 코드, 이슈 및 각종 지표) -- 분석 보고서 --는 SonarQube Server로 전달되고, 이후 Compute Enginer이 마지막 처리를 수행합니다.
이 분석 보고서들은 이후 순차적으로 처리됩니다. 동시에 처리 가능한 분석 보고서의 수는 $SQ_HOME/conf/sonar.properties 파일에서 sonar.ce.workerCount 속성값으로 변경할 수 있습니다(기본값 1).
시스템 관리자는 Administration > Projects > Background Tasks 메뉴를 통해 현재 대기열의 분석 보고서를 확인할 수 있습니다..
필터
Backgound Tasks를 다음 기준에 따라 필터링할 수 있습니다: Pending, Success, Failed 및 Canceled.
"Only Latest Analysis" 버튼을 클릭하면, 각 프로젝트의 가장 최근 분석 리포트만을 표시합니다.
페이지 상단에는 2개 혹은 3개의 카운터를 표시합니다:
- pending - 대기열에서 처리 대기중인 분석 보고서의 수를 표시합니다.
- failures - 가장 최근 분석 보고서 처리에 실패한 프로젝트의 수를 표시합니다
- duration-to-date of the task - 분석 보고서를 처리하는 동안 소요된 시간을 표시합니다.
Project 레벨에서는, 해당 프로젝트의 분석 보고서가 처리 대기 중 상태에 있을 경우 헤더에 "Pending"으로 표시합니다.
처리중인 Background Task는 "wait" 아이콘으로 표시합니다:
The Background Task being processing is marked with a rolling "wait" icon:
임포트 취소
다음의 방법으로 태스크 처리를 취소할 수 있습니다:
- 대기 중 상태인 태스크 목록의 'x; 버튼을 클릭합니다. 해당 태스크의 처리를 취소합니다.
- 대기 중 상태인 태스크 목록의 'bulk cancel'을 클릭합니다. 대기 중 상태인 모든 태스크의 처리를 취소합니다.
로그
분석 보고서의 드롭 다운 메뉴를 사용해 "Scanner Context"에 접속할 수 있습니다. 이 페이지는 코드 스캐닝 수행 시점의 Scanner 환경 설정 정보를 표시합니다.
분석이 실패하는 경우, 해당 드롭다운 메뉴의 "Show Error Details"를 클릭해 Background Task 처리 실패와 관련된 기술적인 세부 내용을 확인할 수 있습니다.
기타 태스크
Background Tasks 페이지에서는 Governance Plugin이 트리거한 View Computation과 같은 다른 처리 내용도 확인할 수 있습니다.
