GitHub, PR 병합 전 코드 커버리지 하락 차단 기능 공개

GitHub 공식 변경 로그에 따르면 회사는 2026년 6월 30일 pull request 병합 전 코드 커버리지 기준을 적용할 수 있는 ‘code coverage merge protection’ 기능을 공개했다. 이 기능은 브랜치 규칙셋을 통해 테스트 커버리지가 사전에 정한 기준 아래로 떨어지는 경우 병합을 막는 방식으로 동작한다.

GitHub는 사용자가 최소 커버리지 비율, 기본 브랜치 대비 허용 가능한 커버리지 하락폭, 또는 두 조건을 함께 설정할 수 있다고 설명했다. 팀은 먼저 evaluate mode로 영향 범위를 살펴본 뒤, 준비가 되면 active mode로 전환해 실제 병합 보호 정책을 적용할 수 있다.

이번 기능은 GitHub Code Quality 사용자를 대상으로 github.com에서 공개 프리뷰로 제공된다. GitHub 문서에 따르면 Code Quality는 GitHub Team과 GitHub Enterprise Cloud에서 사용할 수 있으며, GitHub Enterprise Server에는 아직 제공되지 않는다. 공개 프리뷰 기간에는 Code Quality 자체 과금은 적용되지 않지만, 분석 작업은 GitHub Actions minutes를 사용할 수 있다.

코드 커버리지 결과를 사용하려면 저장소에서 테스트 커버리지 보고서를 생성해 GitHub에 업로드해야 한다. GitHub Docs는 Cobertura XML 형식의 커버리지 보고서를 생성하고 `actions/upload-code-coverage@v1` 액션으로 업로드하는 절차를 안내한다. 문서는 Python, Java, JavaScript·TypeScript, Ruby, Go 등 주요 언어별 커버리지 보고서 생성 예시도 함께 제시했다.

이 변화는 코드 품질 관리가 사후 리포트에서 병합 전 정책 집행으로 이동하고 있음을 보여준다. 특히 여러 저장소를 운영하는 조직에서는 테스트 기준을 수동 리뷰에만 의존하지 않고, 브랜치 규칙셋과 CI 결과를 묶어 일관된 품질 기준을 적용할 수 있다.

다만 공개 프리뷰 기능인 만큼 실제 적용 전에는 기존 CI 시간, 커버리지 측정 방식, 예외 처리 절차를 함께 검토해야 한다. 커버리지 수치가 높다고 결함이 사라지는 것은 아니며, 낮은 품질의 테스트가 수치를 채우는 방식으로 운영될 가능성도 있다. 따라서 병합 차단 기준은 코드 리뷰, 정적 분석, 보안 검사와 함께 보완적으로 설계하는 것이 현실적이다.

출처: GitHub Changelog https://github.blog/changelog/2026-06-30-github-code-coverage-merge-protection-for-pull-requests/ ; GitHub Docs https://docs.github.com/code-security/how-tos/maintain-quality-code/set-up-code-coverage ; GitHub Docs https://docs.github.com/code-security/how-tos/maintain-quality-code/enable-code-quality