Bitbucket Webhook 이벤트 - AWS CodeBuild

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

Bitbucket Webhook 이벤트

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

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

이벤트

Bitbucket의 경우 다음 이벤트 중 하나 이상을 선택할 수 있습니다.

  • PUSH

  • PULL_REQUEST_CREATED

  • PULL_REQUEST_UPDATED

  • PULL_REQUEST_MERGED

  • PULL_REQUEST_CLOSED

webhook의 이벤트 유형은 X-Event-Key 필드의 헤더에 있습니다. 다음 표에서는 X-Event-Key 헤더 값이 이벤트 유형에 매핑되는 방법을 보여 줍니다.

참고

PULL_REQUEST_MERGED 이벤트 유형을 사용하는 webhook 필터 그룹을 생성할 경우 Bitbucket webhook 설정의 merged 이벤트를 활성화해야 합니다. 또한 declined 이벤트 유형을 사용하는 웹후크 필터 그룹을 생성하는 경우 Bitbucket 웹후크 설정에서 PULL_REQUEST_CLOSED 이벤트를 활성화해야 합니다.

X-Event-Key 헤더 값 이벤트 유형
repo:push PUSH
pullrequest:created PULL_REQUEST_CREATED
pullrequest:updated PULL_REQUEST_UPDATED
pullrequest:fulfilled PULL_REQUEST_MERGED
pullrequest:rejected PULL_REQUEST_CLOSED

PULL_REQUEST_MERGED의 경우 풀 요청이 스쿼시 전략에 병합되고 풀 요청 분기가 닫히면 원래의 풀 요청 커밋은 더 이상 존재하지 않게 됩니다. 이 경우 CODEBUILD_WEBHOOK_MERGE_COMMIT 환경 변수에는 스쿼시된 병합 커밋의 식별자가 포함됩니다.

하나 이상의 선택적 필터

정규식을 사용하여 필터를 지정합니다. 이벤트가 빌드를 트리거하려면 연결된 그룹 내의 필터가 모두 true로 평가되어야 합니다.

ACTOR_ACCOUNT_ID(콘솔의 ACTOR_ID)

Bitbucket 계정 ID가 정규식 패턴과 일치하면 Webhook 이벤트가 빌드를 트리거합니다. Webhook 필터 페이로드에 있는 actor 객체의 account_id 속성에 이 값이 표시됩니다.

HEAD_REF

헤드 참조가 정규식 패턴(예: refs/heads/branch-namerefs/tags/tag-name)과 일치하면 webhook 이벤트가 빌드를 트리거합니다. HEAD_REF 필터가 브랜치나 태그의 Git 참조 이름을 평가합니다. Webhook 페이로드의 push 객체에 있는 new 객체의 name 필드에 브랜치 또는 태그 이름이 표시됩니다. pull 요청 이벤트의 경우 webhook 페이로드의 source 객체에 있는 branch 객체의 name 필드에 브랜치 이름이 표시됩니다.

BASE_REF

베이스 참조가 정규식 패턴과 일치하면 webhook 이벤트가 빌드를 트리거합니다. BASE_REF 필터는 풀 요청 이벤트에서만 작동합니다(예: refs/heads/branch-name). BASE_REF 필터가 브랜치의 Git 참조 이름을 평가합니다. Webhook 페이로드의 destination 객체에 있는 branch 객체의 name 필드에 브랜치 이름이 표시됩니다.

FILE_PATH

변경된 파일의 경로가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다.

COMMIT_MESSAGE

헤드 커밋 메시지가 정규식 패턴과 일치하면 webhook가 빌드를 트리거합니다.

WORKFLOW_NAME

워크플로 이름이 정규식 패턴과 일치하면 웹후크가 빌드를 트리거합니다.

참고

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