Bitbucket Webhook 이벤트 필터링(콘솔)Bitbucket Webhook 이벤트 필터링(SDK) Bitbucket Webhook 이벤트 필터링(AWS CloudFormation)

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-name 및 refs/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가 빌드를 트리거합니다.

참고

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

주제

Bitbucket Webhook 이벤트 필터링(콘솔)
Bitbucket Webhook 이벤트 필터링(SDK)
Bitbucket Webhook 이벤트 필터링(AWS CloudFormation)

Bitbucket Webhook 이벤트 필터링(콘솔)

를 사용하여 웹후크 이벤트를 AWS Management Console 필터링하려면:

프로젝트를 생성할 때 코드 변경이 이 리포지토리로 푸시될 때마다 다시 빌드를 선택합니다.
이벤트 유형에서 하나 이상의 이벤트를 선택합니다.
이벤트가 빌드를 트리거할 때를 필터링하려면 Start a build under these conditions(다음 조건에서 빌드를 시작)에서 하나 이상의 선택적 필터를 추가합니다.
이벤트가 트리거되지 않을 때를 필터링하려면 Don't start a build under these conditions(다음 조건에서 빌드를 시작하지 않음)에서 하나 이상의 선택적 필터를 추가합니다.
Add filter group(필터 그룹 추가)를 선택하여 다른 필터 그룹을 추가합니다.

자세한 내용을 알아보려면 AWS CodeBuild API 참조의 빌드 프로젝트 만들기(콘솔) 및 WebhookFilter 섹션을 참조하세요.

이 예제에서는 Webhook 필터 그룹이 pull 요청에 대해서만 빌드를 트리거합니다.

두 필터 그룹을 사용하는 예제에서는 하나 또는 두 필터 그룹이 true로 평가되면 빌드가 트리거됩니다.

첫 번째 필터 그룹은 정규식 ^refs/heads/main$와 일치하는 Git 참조 이름과 ^refs/heads/branch1!와 일치하는 헤드 참조를 갖는 브랜치에서 생성 또는 업데이트된 pull 요청을 지정합니다.
두 번째 필터 그룹은 정규식 ^refs/heads/branch1$와 일치하는 Git 참조 이름을 갖는 브랜치에서 push 요청을 지정합니다.

이 예제에서는 Webhook 필터 그룹이 태그 이벤트를 제외한 모든 요청에 대해 빌드를 트리거합니다.

이 예제에서는 Webhook 필터 그룹이 정규식 ^buildspec.*와 일치하는 이름을 갖는 파일이 변경될 때만 빌드를 트리거합니다.

이 예제에서 Webhook 필터 그룹은 파일이 src 또는 test 폴더에서 변경된 경우에만 빌드를 트리거합니다.

이 예제에서는 Webhook 필터 그룹이 계정 ID가 정규식 actor-account-id와 일치하지 않는 Bitbucket 사용자가 변경을 수행한 경우에만 빌드를 트리거합니다.

참고

Bitbucket 계정 ID를 확인하는 자세한 방법은 https://api.bitbucket.org/2.0/users/user-name을 참조하십시오. 여기서 user-name은 사용자의 Bitbucket 사용자 이름입니다.

이 예제에서 webhook 필터 그룹은 헤드 커밋 메시지가 정규식 \[CodeBuild\]와 일치할 때 푸시 이벤트에 대한 빌드를 트리거합니다.

Bitbucket Webhook 이벤트 필터링(SDK)

AWS CodeBuild SDK를 사용하여 웹후크 이벤트를 필터링하려면 CreateWebhook 또는 UpdateWebhook API 메서드의 요청 구문에 있는 filterGroups 필드를 사용하십시오. 자세한 내용을 알아보려면 CodeBuild API 참조의 WebhookFilter(을)를 참조하세요.

pull 요청에 대해서만 빌드를 트리거하는 Webhook 필터를 생성하려면 요청 구문에 다음을 삽입합니다.


"filterGroups": [
  [
    {
      "type": "EVENT",
      "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
    }
  ]
]

지정된 브랜치에 대해서만 빌드를 트리거하는 Webhook 필터를 생성하려면 pattern 파라미터를 사용하여 브랜치 이름을 필터링하는 정규식을 지정합니다. 두 필터 그룹을 사용하는 예제에서는 하나 또는 두 필터 그룹이 true로 평가되면 빌드가 트리거됩니다.

첫 번째 필터 그룹은 정규식 ^refs/heads/main$와 일치하는 Git 참조 이름과 ^refs/heads/myBranch$와 일치하는 헤드 참조를 갖는 브랜치에서 생성 또는 업데이트된 pull 요청을 지정합니다.
두 번째 필터 그룹은 정규식 ^refs/heads/myBranch$와 일치하는 Git 참조 이름을 갖는 브랜치에서 push 요청을 지정합니다.


"filterGroups": [
  [
    {
      "type": "EVENT",
      "pattern": "PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_CLOSED"
    },
    {
      "type": "HEAD_REF",
      "pattern": "^refs/heads/myBranch$"
    },
    {
      "type": "BASE_REF",
      "pattern": "^refs/heads/main$"
    }
  ],
  [
    {
      "type": "EVENT",
      "pattern": "PUSH"
    },
    {
      "type": "HEAD_REF",
      "pattern": "^refs/heads/myBranch$"
    }
  ]
]

excludeMatchedPattern 파라미터를 사용하여 빌드를 트리거하지 않을 이벤트를 지정할 수 있습니다. 이 예제에서는 태그 이벤트를 제외한 모든 요청에 대해 빌드가 트리거됩니다.


"filterGroups": [
  [
    {
      "type": "EVENT",
      "pattern": "PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
    },
    {
      "type": "HEAD_REF",
      "pattern": "^refs/tags/.*",
      "excludeMatchedPattern": true
    }
  ]
]

계정 ID가 actor-account-id인 Bitbucket 사용자가 변경을 수행한 경우에만 빌드를 트리거하는 필터를 생성할 수 있습니다.

참고


"filterGroups": [
  [
    {
      "type": "EVENT",
      "pattern": "PUSH, PULL_REQUEST_CREATED, PULL_REQUEST_UPDATED, PULL_REQUEST_MERGED, PULL_REQUEST_CLOSED"
    },
    {
      "type": "ACTOR_ACCOUNT_ID",
      "pattern": "actor-account-id"
    }
  ]
]

pattern 인수의 정규식과 일치하는 이름을 갖는 파일이 변경되는 경우에만 빌드를 트리거하는 필터를 생성할 수 있습니다. 이 예제에서는 필터 그룹이 정규식 ^buildspec.*와 일치하는 이름을 갖는 파일이 변경될 때만 빌드가 트리거되도록 지정합니다.


"filterGroups": [
  [
    {
      "type": "EVENT",
      "pattern": "PUSH"
    },
    {
      "type": "FILE_PATH",
      "pattern": "^buildspec.*"
    }
  ]
]

이 예제에서 필터 그룹은 파일이 src 또는 test 폴더에서 변경될 때만 빌드가 트리거되도록 지정합니다.


"filterGroups": [
    [
        {
            "type": "EVENT", 
            "pattern": "PUSH"
        },
        {
            "type": "FILE_PATH", 
            "pattern": "^src/.+|^test/.+"
        }
    ]
]

헤드 커밋 메시지가 패턴 인수의 정규식과 일치할 때만 빌드를 트리거하는 필터를 생성할 수 있습니다. 이 예제에서 필터 그룹은 푸시 이벤트의 헤드 커밋 메시지가 정규식 \[CodeBuild\]와 일치할 때만 빌드가 트리거되도록 지정합니다.


  "filterGroups": [
    [
      {
        "type": "EVENT",
        "pattern": "PUSH"
      },
      {
        "type": "COMMIT_MESSAGE",
        "pattern": "\[CodeBuild\]"
      }
    ]
  ]

Bitbucket Webhook 이벤트 필터링(AWS CloudFormation)

AWS CloudFormation 템플릿을 사용하여 웹후크 이벤트를 필터링하려면 AWS CodeBuild 프로젝트의 속성을 사용하십시오. FilterGroups 다음 AWS CloudFormation 템플릿의 YAML 형식 부분은 두 개의 필터 그룹을 생성합니다. 이들은 하나 또는 둘 모두 true로 평가되면 빌드를 트리거합니다.

첫 번째 필터 그룹은 계정 ID가 12345와 일치하지 않는 Bitbucket 사용자가 정규식 ^refs/heads/main$와 일치하는 Git 참조 이름을 갖는 브랜치에서 생성 또는 업데이트한 pull 요청을 지정합니다.
두 번째 필터 그룹은 정규식 ^refs/heads/.*와 일치하는 Git 참조 이름을 갖는 브랜치에서 생성되는 push 요청을 지정합니다.
세 번째 필터 그룹은 정규식 \[CodeBuild\]와 일치하는 헤드 커밋 메시지에서 push 요청을 지정합니다.


CodeBuildProject:
  Type: AWS::CodeBuild::Project
  Properties:
    Name: MyProject
    ServiceRole: service-role
    Artifacts:
      Type: NO_ARTIFACTS
    Environment:
      Type: LINUX_CONTAINER
      ComputeType: BUILD_GENERAL1_SMALL
      Image: aws/codebuild/standard:5.0
    Source:
      Type: BITBUCKET
      Location: source-location
    Triggers:
      Webhook: true
      FilterGroups:
        - - Type: EVENT
            Pattern: PULL_REQUEST_CREATED,PULL_REQUEST_UPDATED
          - Type: BASE_REF
            Pattern: ^refs/heads/main$
            ExcludeMatchedPattern: false
          - Type: ACTOR_ACCOUNT_ID
            Pattern: 12345
            ExcludeMatchedPattern: true
        - - Type: EVENT
            Pattern: PUSH
          - Type: HEAD_REF
            Pattern: ^refs/heads/.*
          - Type: FILE_PATH
            Pattern: READ_ME
            ExcludeMatchedPattern: true
        - - Type: EVENT
            Pattern: PUSH
          - Type: COMMIT_MESSAGE
            Pattern: \[CodeBuild\]
          - Type: FILE_PATH
            Pattern: ^src/.+|^test/.+

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Webhook

GitHub 웹후크 이벤트