GitHub 웹후크 이벤트 - AWS CodeBuild

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GitHub 웹후크 이벤트

웹후크 필터 그룹을 사용하여 빌드를 트리거하는 GitHub 웹후크 이벤트를 지정할 수 있습니다. 예를 들어 특정 분기가 변경된 경우에만 빌드가 트리거되도록 지정할 수 있습니다.

하나 이상의 Webhook 필터 그룹을 생성하여 어느 Webhook 이벤트가 빌드를 트리거할지 지정할 수 있습니다. 필터 그룹이 true로 평가(그룹 내 모든 필터가 true로 평가)되면 빌드가 트리거됩니다. 필터 그룹을 생성할 때 다음을 지정합니다.

이벤트

의 경우 GitHub, PUSH, , , , PULL_REQUEST_CREATED, PULL_REQUEST_UPDATEDPULL_REQUEST_REOPENEDPULL_REQUEST_MERGEDPULL_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 closedmerged 필드는 true PULL_REQUEST_MERGED
pull_request closedmerged 필드는 false PULL_REQUEST_CLOSED
push 해당 사항 없음 PUSH
release 릴리스됨 RELEASED
release 사전 릴리스됨 PRERELEASED
workflow_job queued WORKFLOW_JOB_QUEUED
참고

PULL_REQUEST_REOPENED 이벤트 유형은 및 GitHub Enterprise Server에서만 사용할 GitHub 수 있습니다. RELEASED, PRERELEASEDWORKFLOW_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 리포지토리의 웹후크 설정에서 웹후크 페이로드를 찾을 수 있습니다.