끌어오기 요청이 차단되는 이유 이해
리포지토리 관리자 및 조직 소유자는 .를 사용하여 품질 게이트를 GitHub Code Quality설정할 수 있습니다. 끌어오기 요청을 열면 자동으로 검사를 실행하여 이러한 표준에 대한 변경 내용을 평가합니다.
블록에는 다음 두 가지 유형이 있습니다.
- 코드 품질 결과: 변경 내용으로 인해 필요한 품질 임계값 아래로 떨어지는 문제가 발생합니다.
- 적용 범위 임계값: 변경 내용으로 인해 코드 검사 범위가 필요한 최소값 아래로 떨어지거나 기본 분기를 기준으로 허용된 크기보다 많은 범위가 삭제됩니다.
이러한 검사는 정상적이고 유지 관리 가능한 코드베이스를 유지하고 기술 부채가 누적되는 것을 방지하는 데 도움이 됩니다.
코드 품질 결과 블록 해결
끌어오기 요청에 필요한 품질 임계값보다 낮은 코드가 도입되면 "검사" 섹션의 끌어오기 요청 아래쪽에 병합 블록 배너가 표시됩니다. "병합이 차단됨: 코드 품질 결과가 검색되었습니다."
리포지토리 관리자 또는 조직 소유자가 설정한 품질 게이트는 병합을 차단하는 최소 심각도 수준을 정의합니다. 병합하려면 먼저 해당 심각도 이상의 모든 결과를 수정하거나 해제해야 합니다. 병합 블록 배너가 심각도 수준을 지정하지 않으면 리포지토리에서 모든 결과를 처리해야 합니다.
끌어오기 요청을 차단 해제하려면 차단 심각도를 충족하거나 초과하는 결과를 수정하거나 해제해야 합니다.
- 풀 리퀘스트에
github-code-quality[bot]이(가) 남긴 댓글을 검토하세요. 각 주석은 심각도(오류, 경고, 참고)로 레이블이 지정됩니다. - 관련 결과를 수정하거나 해제합니다. 자세한 지침은 끌어오기 요청에서 코드 품질 결과 수정을 참조하세요.
- 풀 리퀘스트의 "Checks" 섹션에 병합 차단 배너가 더 이상 표시되지 않는지 확인하세요.
적용 범위 임계값 블록 해결
끌어오기 요청이 적용 범위 임계값 규칙에 의해 차단된 경우 "검사" 섹션에 임계값을 충족하지 못한 임계값을 설명하는 메시지와 함께 병합 블록 배너가 표시됩니다. 다음은 그 예입니다.
- "커버리지 22.0%가 최소 50.0%보다 낮습니다": pull request 브랜치 커버리지가 규칙 세트에 구성된 최소 커버리지 비율보다 낮습니다.
- "적용 범위는%2.5로 감소하고, 허용되는 최대 감소는 1.0%": 변경으로 인해 기본 분기를 기준으로 허용된 금액보다 많은 범위가 감소했습니다.
끌어오기 요청을 차단 해제하려면 더 많은 코드베이스가 실행되도록 테스트를 추가하거나 수정해야 합니다.
- 끌어오기 요청에 대한 적용 범위 요약 주석을 검토하여 적용 범위가 부족한 파일 또는 영역을 식별합니다.
- 테스트를 추가하거나 업데이트하여 실행 범위를 높입니다. Copilot 는 테스트를 작성하고 업데이트하는 데 도움이 될 수 있습니다. 코드 테스트을(를) 참조하세요.
- 변경 사항을 푸시하세요. 커버리지 검사가 자동으로 다시 실행됩니다.