Skip to main content

상태 검사 정보

상태 검사를 통해 커밋이 사용자가 기여하는 리포지토리에 대해 설정된 조건을 충족하는지 알 수 있습니다.

상태 검사는 리포지토리에 대한 각 푸시에 대해 실행되는 지속적 통합 빌드와 같은 외부 프로세스를 기반으로 합니다. 끌어오기 요청의 개별 커밋 옆에 있는 상태 검사의 보류 중, 전달 또는 실패 상태를 볼 수 있습니다.

커밋 및 상태 목록의 스크린샷입니다.

리포지토리에 대한 쓰기 권한이 있는 사용자는 리포지토리의 상태 검사 상태를 설정할 수 있습니다.

리포지토리의 분기 페이지 또는 리포지토리의 끌어오기 요청 목록에서 분기에 대한 마지막 커밋의 전체 상태를 볼 수 있습니다.

리포지토리에 대한 상태 검사가 필요한 경우 분기를 보호된 분기에 병합하기 전에 필요한 상태 검사를 통과해야 합니다. 자세한 내용은 "보호된 분기 정보"을(를) 참조하세요.

참고: 건너뛴 작업은 해당 상태를 “성공”으로 보고합니다. 필요한 검사인 경우에도 끌어오기 요청이 병합되는 것을 방지하지 않습니다.

GitHub에 대한 상태 검사 유형

GitHub에 대한 두 가지 유형의 상태 검사가 있습니다.

  • 확인
  • 커밋 상태

_검사_는 행 주석과 더 자세한 메시지를 제공하고 GitHub Apps에서만 사용할 수 있다는 점에서 _커밋 상태_와 다릅니다.

참고: 워크플로를 실행할 때 GitHub Actions에서 커밋 상태가 아닌 검사를 생성합니다.

리포지토리에 대한 푸시 액세스 권한이 있는 조직 소유자 및 사용자는 GitHub의 API를 사용하여 검사 및 커밋 상태를 만들 수 있습니다. 자세한 내용은 "검사에 대한 REST API 엔드포인트" 및 "커밋 상태에 대한 REST API 엔드포인트" 항목을 참조하세요.

확인

_검사_가 리포지토리에 설정되면 끌어오기 요청에는 검사에서 자세한 빌드 출력을 보고 실패한 검사를 다시 실행할 수 있는 검사 탭이 있습니다.

참고: 확인 탭은 리포지토리에 대해 _커밋 상태_가 아니라 _확인_을 설정한 경우에만 끌어오기 요청에 대해 채워집니다.

커밋의 특정 줄로 인해 검사가 실패하는 경우 끌어오기 요청의 파일 탭에 있는 관련 코드 옆에 오류, 경고 또는 알림에 대한 세부 정보가 표시됩니다.

확인 탭 아래의 커밋 드롭다운 메뉴를 사용하여 끌어오기 요청의 다양한 커밋에 대한 검사 요약을 탐색할 수 있습니다.

끌어오기 요청의 "파일 변경됨" 탭 스크린샷입니다. 커밋을 선택하는 "확인" 탭과 드롭다운 메뉴가 모두 진한 주황색 윤곽선으로 표시되어 있습니다.

개별 커밋에 대한 검사 건너뛰기 및 요청

리포지토리가 푸시에 대한 검사를 자동으로 요청하도록 설정된 경우 푸시하는 개별 커밋에 대한 검사를 건너뛰도록 선택할 수 있습니다. 리포지토리가 푸시 검사를 자동으로 요청하도록 설정되지 않은 경우 푸시한 개별 커밋에 대한 검사를 요청할 수 있습니다. 이러한 설정에 대한 자세한 내용은 "검사 도구 모음에 대한 REST API 엔드포인트"을(를) 참조하세요.

커밋 메시지에 명령을 포함하여 pushpull_request 이벤트에 의해 트리거되는 워크플로 실행을 건너뛸 수도 있습니다. 자세한 내용은 "워크플로 실행 건너뛰기"을(를) 참조하세요.

또는 커밋에 대한 모든 검사를 건너뛰거나 요청하려면 커밋 메시지의 끝에 다음 트레일러 줄 중 하나를 추가합니다.

  • 커밋에 대한 확인을 건너뛰려면 커밋 메시지와 변경 내용에 대한 짧고 의미 있는 설명을 입력합니다. 커밋 설명 뒤 닫는 따옴표 앞에 빈 줄 두 개를 추가하고 그 뒤에 skip-checks: true을 추가합니다.

    $ git commit -m "Update README
    >
    >
    skip-checks: true"
    
  • 커밋 확인을 _요청_하려면 커밋 메시지와 변경 내용에 대한 짧고 의미 있는 설명을 입력합니다. 커밋 설명 뒤 닫는 따옴표 앞에 빈 줄 두 개를 추가하고 그 뒤에 request-checks: true을 추가합니다.

    $ git commit -m "Refactor usability tests
    >
    >
    request-checks: true"
    

기본적으로 Git은 연속된 줄임표를 자동으로 제거합니다. 입력한 대로 커밋 메시지를 그대로 두려면 커밋에 --cleanup=verbatim 옵션을 사용합니다. 자세한 내용은 Git 설명서의 --cleanup=<mode>를 참조하세요.

검사 보존

GitHub은(는) 400일 동안 검사 데이터를 보존합니다. 400일이 지나면 데이터가 보관됩니다. 보관 후 10일이 지나면 데이터가 영구적으로 삭제됩니다.

끌어오기 요청을 필수 및 보관된 검사와 병합하려면 검사를 다시 실행해야 합니다.