GitHub 웹후크 이벤트 - AWS CodeBuild

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

GitHub 웹후크 이벤트

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

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

이벤트

의 경우 GitHub,,,,PUSH,, PULL_REQUEST_CREATED PULL_REQUEST_UPDATED PULL_REQUEST_REOPENED PULL_REQUEST_MERGED PULL_REQUEST_CLOSED RELEASEDPRERELEASED, 및 이벤트 중 하나 이상을 선택할 수 있습니다. 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 엔터프라이즈 서버에서만 사용할 수 있습니다. GitHub RELEASEDPRERELEASED, 및 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 엔터프라이즈 서버 푸시 이벤트와 함께 사용할 수 있습니다. GitHub엔터프라이즈 서버 풀 리퀘스트 이벤트와 함께 사용할 수 없습니다.

COMMIT_MESSAGE

헤드 커밋 메시지가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다. COMMIT_MESSAGE필터는 GitHub 푸시 및 풀 요청 이벤트 및 GitHub 엔터프라이즈 서버 푸시 이벤트와 함께 사용할 수 있습니다. GitHub엔터프라이즈 서버 풀 리퀘스트 이벤트와 함께 사용할 수 없습니다.

TAG_NAME

웹후크는 릴리스의 태그 이름이 정규 표현식 패턴과 일치할 때 빌드를 트리거합니다. TAG_NAME필터는 릴리즈된 요청 이벤트 및 GitHub 프리릴리즈된 요청 이벤트와 함께 사용할 수 있습니다.

RELEASE_NAME

웹후크는 릴리스 이름이 정규 표현식 패턴과 일치할 때 빌드를 트리거합니다. RELEASE_NAME필터는 릴리즈된 요청 이벤트 및 GitHub 프리릴리즈된 요청 이벤트와 함께 사용할 수 있습니다.

REPOSITORY_NAME

웹후크는 리포지토리 이름이 정규 표현식 패턴과 일치할 때 빌드를 트리거합니다. REPOSITORY_NAME필터는 GitHub 글로벌 또는 조직 웹후크에만 사용할 수 있습니다.

WORKFLOW_NAME

웹후크는 워크플로 이름이 정규 표현식 패턴과 일치할 때 빌드를 트리거합니다. WORKFLOW_NAME필터는 GitHub Actions 워크플로 작업 대기 요청 이벤트와 함께 사용할 수 있습니다.

참고

웹후크 페이로드는 리포지토리의 웹후크 설정에서 찾을 수 있습니다. GitHub