기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GitHub 웹후크 이벤트
웹후크 필터 그룹을 사용하여 빌드를 트리거하는 GitHub 웹후크 이벤트를 지정할 수 있습니다. 예를 들어 특정 분기가 변경된 경우에만 빌드가 트리거되도록 지정할 수 있습니다.
하나 이상의 Webhook 필터 그룹을 생성하여 어느 Webhook 이벤트가 빌드를 트리거할지 지정할 수 있습니다. 필터 그룹이 true로 평가(그룹 내 모든 필터가 true로 평가)되면 빌드가 트리거됩니다. 필터 그룹을 생성할 때 다음을 지정합니다.
- 이벤트
-
의 경우 GitHub,
PUSH
, , , ,PULL_REQUEST_CREATED
,PULL_REQUEST_UPDATED
PULL_REQUEST_REOPENED
PULL_REQUEST_MERGED
PULL_REQUEST_CLOSED
,PRERELEASED
,RELEASED
, 중 하나 이상의 이벤트를 선택할 수 있습니다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
참고
PULL_REQUEST_REOPENED
이벤트 유형은 및 GitHub Enterprise Server에서만 사용할 GitHub 수 있습니다.RELEASED
,PRERELEASED
및WORKFLOW_JOB_QUEUED
이벤트 유형은 GitHub 에서만 사용할 수 있습니다.WORKFLOW_JOB_QUEUED
에 대한 자세한 내용은 자습서: CodeBuild호스팅된 GitHub 작업 러너 구성 단원을 참조하세요. - 하나 이상의 선택적 필터
-
정규식을 사용하여 필터를 지정합니다. 이벤트가 빌드를 트리거하려면 연결된 그룹 내의 필터가 모두 true로 평가되어야 합니다.
ACTOR_ACCOUNT_ID
(콘솔의ACTOR_ID
)-
웹후크 이벤트는 GitHub 또는 GitHub Enterprise Server 계정 ID가 정규 표현식 패턴과 일치할 때 빌드를 트리거합니다. 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 푸시 앤 풀 요청 이벤트 및 GitHub Enterprise Server 푸시 이벤트와 함께 사용할 수 있습니다. Enterprise Server 풀 요청 이벤트에서는 GitHub 사용할 수 없습니다. COMMIT_MESSAGE
-
헤드 커밋 메시지가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다.
COMMIT_MESSAGE
필터는 GitHub 푸시 및 풀 요청 이벤트와 GitHub 엔터프라이즈 서버 푸시 이벤트에 사용할 수 있습니다. Enterprise Server 풀 요청 이벤트에서는 GitHub 사용할 수 없습니다. TAG_NAME
-
릴리스의 태그 이름이 정규 표현식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.
TAG_NAME
필터는 GitHub 릴리스 및 사전 릴리스된 요청 이벤트와 함께 사용할 수 있습니다. RELEASE_NAME
-
릴리스 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.
RELEASE_NAME
필터는 GitHub 릴리스 및 사전 릴리스된 요청 이벤트와 함께 사용할 수 있습니다. REPOSITORY_NAME
-
리포지토리 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.
REPOSITORY_NAME
필터는 GitHub 글로벌 또는 조직 웹후크에서만 사용할 수 있습니다. WORKFLOW_NAME
-
워크플로 이름이 정규 표현식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.
WORKFLOW_NAME
필터는 GitHub 작업 워크플로 작업 대기열 요청 이벤트와 함께 사용할 수 있습니다.
참고
GitHub 리포지토리의 웹후크 설정에서 웹후크 페이로드를 찾을 수 있습니다.