GitHub Webhook 이벤트 - AWS CodeBuild

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

GitHub Webhook 이벤트

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 이벤트 유형을 사용할 수 있습니다. RELEASED 및 PRERELEASED 이벤트 유형은 GitHub에서만 사용할 수 있습니다. 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 글로벌 또는 조직 웹후크에서만 사용할 수 있습니다.

ORGANIZATION_NAME

조직 이름이 정규식 패턴과 일치하면 Webhook가 빌드를 트리거합니다. ORGANIZATION_NAME 필터는 GitHub 글로벌 웹후크에서만 사용할 수 있습니다.

WORKFLOW_NAME

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

참고

GitHub 리포지토리의 webhook 설정에서 webhook 페이로드를 찾을 수 있습니다.

주제