Webhook 필터 그룹을 사용하여 어느 GitHub Webhook 이벤트가 빌드를 트리거할지 지정할 수 있습니다. 예를 들어 특정 분기가 변경된 경우에만 빌드가 트리거되도록 지정할 수 있습니다.
하나 이상의 Webhook 필터 그룹을 생성하여 어느 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
이벤트 유형을 사용할 수 있습니다.WORKFLOW_JOB_QUEUED
에 대한 자세한 내용은 자습서: CodeBuild 호스팅 GitHub Action 실행기 구성 단원을 참조하세요. - 하나 이상의 선택적 필터
-
정규식을 사용하여 필터를 지정합니다. 이벤트가 빌드를 트리거하려면 연결된 그룹 내의 필터가 모두 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 글로벌 또는 조직 웹후크에서만 사용할 수 있습니다. WORKFLOW_NAME
-
워크플로 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.
WORKFLOW_NAME
필터는 GitHub Action 워크플로 작업 대기열 요청 이벤트와 함께 사용할 수 있습니다.
참고
GitHub 리포지토리의 webhook 설정에서 webhook 페이로드를 찾을 수 있습니다.