Filtrar eventos de webhook do Bitbucket - AWS CodeBuild

Filtrar eventos de webhook do Bitbucket

Você pode usar grupos de filtros de webhook para especificar quais eventos de webhook do Bitbucket acionam uma compilação. Por exemplo, é possível especificar que uma compilação seja acionada somente para alterações em ramificações especificadas.

Você pode criar um ou mais grupos de filtros de webhook para especificar quais eventos de webhook acionam uma compilação. Uma compilação será acionada se algum grupo de filtros for avaliado como verdadeiro, o que ocorre quando todos os filtros no grupo são avaliados como verdadeiros. Ao criar um grupo de filtros, é necessário especificar:

Um evento

Para o Bitbucket, é possível escolher um ou mais dos seguintes eventos:

  • PUSH

  • PULL_REQUEST_CREATED

  • PULL_REQUEST_UPDATED

  • PULL_REQUEST_MERGED

  • PULL_REQUEST_CLOSED

O tipo de evento do webhook está em seu cabeçalho no campos X-Event-Key. A tabela a seguir mostra como valores de cabeçalho X-Event-Key são mapeados para os tipos de eventos.

nota

Você deve habilitar o evento merged em sua configuração de webhook do Bitbucket caso você crie um grupo de filtros de webhook que use o tipo de evento PULL_REQUEST_MERGED. Você também deve habilitar o evento declined em sua configuração de webhook do Bitbucket caso você crie um grupo de filtros do webhook que usa o tipo de evento PULL_REQUEST_CLOSED.

X-Event-KeyValor do cabeçalho Tipo de evento
repo:push PUSH
pullrequest:created PULL_REQUEST_CREATED
pullrequest:updated PULL_REQUEST_UPDATED
pullrequest:fulfilled PULL_REQUEST_MERGED
pullrequest:rejected PULL_REQUEST_CLOSED

Para PULL_REQUEST_MERGED, se uma solicitação pull for mesclada com a estratégia squash e a ramificação da solicitação pull for fechada, a confirmação original da solicitação pull deixará de existir. Nesse caso, a variável de ambiente CODEBUILD_WEBHOOK_MERGE_COMMIT contém o identificador da confirmação de mesclagem comprimida.

Um ou mais filtros opcionais

Use uma expressão regular para especificar um filtro. Para um evento acionar uma compilação, cada filtro do grupo associado a ele deve ser avaliado como verdadeiro.

ACTOR_ACCOUNT_ID (ACTOR_ID no console)

Um evento de webhook aciona uma compilação quando um ID de conta do Bitbucket corresponde ao padrão da expressão regular. Esse valor é exibido na propriedade account_id do objeto actor na carga de filtro webhook.

HEAD_REF

Um evento de webhook aciona uma compilação quando a referência head corresponde ao padrão da expressão regular (por exemplo, refs/heads/branch-name e refs/tags/tag-name). Um filtro HEAD_REF avalia o nome de referência do Git para a ramificação ou tag. O nome de ramificação ou de tag é exibido no campo name do objeto new no objeto push da carga webhook. Para eventos de solicitação pull, o nome da ramificação é exibido no campo name no objeto branch do objeto source na carga webhook.

BASE_REF

Um evento de webhook aciona uma compilação quando a referência base corresponde ao padrão da expressão regular. Um filtro BASE_REF funciona apenas com eventos de solicitação pull (por exemplo, refs/heads/branch-name). Um filtro BASE_REF avalia o nome de referência do Git para a ramificação. O nome da ramificação é exibido no campo name do objeto branch no objeto destination na carga webhook.

FILE_PATH

Um evento de webhook aciona uma compilação quando o caminho de um arquivo alterado corresponde ao padrão da expressão regular.

COMMIT_MESSAGE

Um webhook aciona uma compilação quando a mensagem de confirmação head corresponde à expressão padrão.

WORKFLOW_NAME

Um webhook aciona uma compilação quando o nome do fluxo de trabalho corresponde ao padrão da expressão regular.

nota

Você pode encontrar a carga webhook nas configurações de webhook no seu repositório do Bitbucket.

Tópicos