기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # GitHub Webhook 이벤트 Webhook 필터 그룹을 사용하여 어느 GitHub Webhook 이벤트가 빌드를 트리거할지 지정할 수 있습니다. 예를 들어 특정 분기가 변경된 경우에만 빌드가 트리거되도록 지정할 수 있습니다. 하나 이상의 웹후크 필터 그룹을 생성하여 어느 웹후크 이벤트가 빌드를 트리거할지 지정할 수 있습니다. 필터 그룹이 true로 평가(그룹 내 모든 필터가 true로 평가)되면 빌드가 트리거됩니다. 필터 그룹을 생성할 때 다음을 지정합니다. **이벤트** GitHub의 경우 `PUSH`, `PULL_REQUEST_CREATED`, `PULL_REQUEST_UPDATED`, `PULL_REQUEST_REOPENED`, `PULL_REQUEST_MERGED`, `PULL_REQUEST_CLOSED`, `RELEASED`, `PRERELEASED` 및 `WORKFLOW_JOB_QUEUED` 이벤트 가운데 하나 이상을 선택할 수 있습니다. webhook 이벤트 유형은 webhook 페이로드의 `X-GitHub-Event` 헤더에 있습니다. `X-GitHub-Event` 헤더에서 `pull_request` 또는 `push`를 볼 수 있습니다. 풀 요청 이벤트의 경우 유형은 webhook 이벤트 페이로드의 `action` 필드에 있습니다. 다음 표에서는 `X-GitHub-Event` 헤더 값과 webhook 풀 요청 페이로드 `action` 필드 값이 사용 가능한 이벤트 유형에 매핑되는 방법을 보여 줍니다. [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/codebuild/latest/userguide/github-webhook.html) GitHub 및 GitHub Enterprise Server에서만 `PULL_REQUEST_REOPENED` 이벤트 유형을 사용할 수 있습니다. GitHub에서만 `RELEASED` 및 `PRERELEASED` 이벤트 유형을 사용할 수 있습니다. `WORKFLOW_JOB_QUEUED`에 대한 자세한 내용은 [자습서: CodeBuild 호스팅 GitHub Action 실행기 구성](action-runner.md) 섹션을 참조하세요. **하나 이상의 선택적 필터** 정규식을 사용하여 필터를 지정합니다. 이벤트가 빌드를 트리거하려면 연결된 그룹 내의 필터가 모두 true로 평가되어야 합니다. `ACTOR_ACCOUNT_ID`(콘솔의 `ACTOR_ID`) GitHub 또는 GitHub Enterprise Server 계정 ID가 정규식 패턴과 일치하면 Webhook 이벤트가 빌드를 트리거합니다. webhook 페이로드에 있는 `sender` 객체의 `id` 속성에서 이 값을 찾을 수 있습니다. `HEAD_REF` 헤드 참조가 정규식 패턴(예: `refs/heads/branch-name` 또는 `refs/tags/tag-name`)과 일치하면 webhook 이벤트가 빌드를 트리거합니다. 푸시 이벤트의 경우 webhook 페이로드의 `ref` 속성에서 참조 이름을 찾을 수 있습니다. 풀 요청 이벤트의 경우 webhook 페이로드에 있는 `head` 객체의 `ref` 속성에서 브랜치 이름을 찾을 수 있습니다. `BASE_REF` 기본 참조가 정규식 패턴(예: `refs/heads/branch-name`)과 일치하면 webhook 이벤트가 빌드를 트리거합니다. 풀 요청 이벤트에서만 `BASE_REF` 필터를 사용할 수 있습니다. webhook 페이로드에 있는 `base` 객체의 `ref` 속성에서 브랜치 이름을 찾을 수 있습니다. `FILE_PATH` 변경된 파일의 경로가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다. `FILE_PATH` 필터는 GitHub push 및 pull 요청 이벤트와 GitHub Enterprise Server push 이벤트에서 사용할 수 있습니다. GitHub Enterprise Server pull 요청 이벤트에서는 사용할 수 없습니다. `COMMIT_MESSAGE` 헤드 커밋 메시지가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다. `COMMIT_MESSAGE` 필터는 GitHub push 및 pull 요청 이벤트와 GitHub Enterprise Server push 이벤트에서 사용할 수 있습니다. GitHub Enterprise Server pull 요청 이벤트에서는 사용할 수 없습니다. `TAG_NAME` 릴리스의 태그 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다. `TAG_NAME` 필터는 GitHub 릴리스 및 사전 릴리스된 요청 이벤트와 함께 사용할 수 있습니다. `RELEASE_NAME` 릴리스 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다. `RELEASE_NAME` 필터는 GitHub 릴리스 및 사전 릴리스된 요청 이벤트와 함께 사용할 수 있습니다. `REPOSITORY_NAME` 리포지토리 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다. `REPOSITORY_NAME` 필터는 GitHub 글로벌 또는 조직 웹후크에서만 사용할 수 있습니다. `ORGANIZATION_NAME` 조직 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다. `ORGANIZATION_NAME` 필터는 GitHub 글로벌 웹후크에서만 사용할 수 있습니다. `WORKFLOW_NAME` 워크플로 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다. `WORKFLOW_NAME` 필터는 GitHub Action 워크플로 작업 대기열 요청 이벤트와 함께 사용할 수 있습니다. **참고** GitHub 리포지토리의 webhook 설정에서 webhook 페이로드를 찾을 수 있습니다. **Topics** + [GitHub Webhook 이벤트 필터링(콘솔)](github-webhook-events-console.md) + [GitHub Webhook 이벤트 필터링(SDK)](github-webhook-events-sdk.md) + [GitHub Webhook 이벤트 필터링(CloudFormation)](github-webhook-events-cfn.md)