커버리지 보고와 커버리지 시각화를 사용해 코드 커버리지를 추적합니다. 두 메커니즘은 서로 다른 입력을 읽고, 서로 다른 출력을 만들며, 구성을 공유하지 않습니다. 하나를 구성한다고 해서 다른 하나가 활성화되지는 않습니다.

커버리지 보고는 MR 위젯, 파이프라인 목록, 분석 그래프에 비율을 표시합니다. 커버리지 시각화는 MR diff에 줄별 주석을 표시합니다. 둘 다 사용하려면 두 키워드 (coverage와 artifacts:reports:coverage_report)를 모두 구성합니다.

커버리지가 표시되는 위치#

원하는 커버리지 출력의 키워드를 찾으려면 이 표를 사용합니다. coverage 키워드는 diff 주석을 제외한 모든 출력을 제공합니다.

접근 방식 선택#

두 메커니즘은 서로 다른 입력을 읽고 다르게 동작합니다.

두 메커니즘은 서로 다른 입력을 읽으므로 결과가 서로 다를 수 있습니다. MR 위젯의 비율은 정규 표현식이 로그에서 일치시킨 값입니다. 주석은 XML 보고서에서 가져옵니다. 테스트 명령이 이 둘을 서로 다른 기준으로 계산하면 위젯과 diff가 서로 다른 내용을 설명하게 됩니다. 둘 다 같은 테스트 실행에서 생성합니다.

커버리지 보고#

커버리지 보고는 테스트 도구의 job 로그 출력에서 비율을 추출합니다. coverage 키워드에 정규 표현식을 정의하면 GitLab이 job 로그를 스캔하여 첫 번째로 일치하는 숫자를 추출하고 저장합니다.

GitLab은 이 값을 다음 위치에 표시합니다:

• 대상 브랜치 대비 델타를 포함한 MR 위젯.

• 파이프라인 job 목록.

• Analyze > Repository analytics의 프로젝트별 및 그룹별 커버리지 히스토리 그래프.

• 커버리지 배지.

• 커버리지가 감소할 때 승인을 요구할 수 있는 Coverage-Check 승인 규칙 (Premium 및 Ultimate).

설정 안내는 커버리지 보고 구성을 참조합니다.

커버리지 시각화#

커버리지 시각화는 테스트 job이 CI/CD 아티팩트로 업로드하는 Cobertura 또는 JaCoCo XML 보고서를 파싱합니다. 파이프라인이 완료된 후 GitLab은 백그라운드에서 보고서를 처리하고 MR diff의 줄에 주석을 답니다.

주석은 MR diff에서 변경된 파일에만 표시됩니다. 보고서에 커버리지 데이터가 포함되어 있더라도 MR에서 변경되지 않은 파일에는 주석이 달리지 않습니다.

설정 안내는 커버리지 시각화 구성을 참조합니다.