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 필드 값이 사용 가능한 이벤트 유형에 매핑되는 방법을 보여 줍니다.

`X-GitHub-Event` 헤더 값	Webhook 이벤트 페이로드 `action` 값	이벤트 유형
`pull_request`	`opened`	`PULL_REQUEST_CREATED`
`pull_request`	`reopened`	`PULL_REQUEST_REOPENED`
`pull_request`	`synchronize`	`PULL_REQUEST_UPDATED`
`pull_request`	`closed` 및 `merged` 필드는 `true`임	`PULL_REQUEST_MERGED`
`pull_request`	`closed` 및 `merged` 필드는 `false`임	`PULL_REQUEST_CLOSED`
`push`	해당 사항 없음	`PUSH`
`release`	릴리스	`RELEASED`
`release`	사전 릴리스	`PRERELEASED`
`workflow_job`	queued	`WORKFLOW_JOB_QUEUED`

참고

GitHub 및 GitHub Enterprise Server에서만 PULL_REQUEST_REOPENED 이벤트 유형을 사용할 수 있습니다. GitHub에서만 RELEASED 및 PRERELEASED 이벤트 유형을 사용할 수 있습니다. WORKFLOW_JOB_QUEUED에 대한 자세한 내용은 자습서: CodeBuild 호스팅 GitHub Action 실행기 구성 섹션을 참조하세요.

하나 이상의 선택적 필터

정규식을 사용하여 필터를 지정합니다. 이벤트가 빌드를 트리거하려면 연결된 그룹 내의 필터가 모두 true로 평가되어야 합니다.

CodeBuild는 미리 보기, 뒤로 보기, 역참조 또는 원자 그룹을 지원하지 않는 RE2 정규식 구문을 사용하여 필터 패턴을 평가합니다. 자세한 내용은 GitHub 웹 사이트의 RE2 구문 페이지를 참조하세요.

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 요청 이벤트에서는 사용할 수 없습니다.

참고
FILE_PATH 필터는 푸시 또는 풀 요청에서 처음 100개의 변경된 파일에 대해 평가됩니다. 필터가 의도한 대로 적용되도록 하려면 변경된 파일 수를이 한도 내에서 유지합니다. 풀 요청 이벤트의 경우 풀 요청 빌드 정책을 사용하여 빌드를 시작할 수 있는 풀 요청을 제어하는 것이 좋습니다.
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 페이로드를 찾을 수 있습니다.

주제

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

GitHub 수동 웹후크

GitHub Webhook 이벤트 필터링(콘솔)