View a markdown version of this page

GitHub eventos de webhook - AWS CodeBuild

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

GitHub eventos de webhook

Você pode usar grupos de filtros de webhook para especificar quais eventos de GitHub webhook acionam uma construçã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 GitHub, você pode escolher um ou mais dos seguintes eventos: PUSH PULL_REQUEST_CREATED PULL_REQUEST_UPDATEDPULL_REQUEST_REOPENED,PULL_REQUEST_MERGED,PULL_REQUEST_CLOSED, RELEASEDPRERELEASED,, WORKFLOW_JOB_QUEUED e. O tipo de evento webhook está no cabeçalho X-GitHub-Event na carga webhook. No cabeçalho X-GitHub-Event, você pode ver pull_request ou push. Para obter uma solicitação pull, o tipo de evento está no campo action da carga do evento webhook. A tabela a seguir mostra como valores de cabeçalho X-GitHub-Event e os valores do campo action da carga da solicitação pull webhook são mapeados para os tipos de eventos disponíveis.

Valor do cabeçalho X-GitHub-Event Valor action da carga do evento Webhook Tipo de evento
pull_request opened PULL_REQUEST_CREATED
pull_request reopened PULL_REQUEST_REOPENED
pull_request synchronize PULL_REQUEST_UPDATED
pull_request closed e o campo merged é true PULL_REQUEST_MERGED
pull_request closed e o campo merged é false PULL_REQUEST_CLOSED
push n/a PUSH
release lançado RELEASED
release pré-lançado PRERELEASED
workflow_job queued WORKFLOW_JOB_QUEUED
nota

O tipo de PULL_REQUEST_REOPENED evento pode ser usado somente com GitHub um GitHub Enterprise Server. O tipo de PRERELEASED evento RELEASED e GitHub só pode ser usado com. Para obter mais informações sobre WORKFLOW_JOB_QUEUED, consulte Tutorial: Configurar um executor de CodeBuild-hosted GitHub ações.

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.

CodeBuild avalia os padrões de filtro usando a sintaxe de expressão RE2 regular, que não suporta lookahead, lookbehind, referências anteriores ou grupos atômicos. Para obter mais informações, consulte a página de RE2 sintaxe no GitHub site.

ACTOR_ACCOUNT_ID (ACTOR_ID no console)

Um evento de webhook aciona uma compilação quando um GitHub ID de conta do GitHub Enterprise Server corresponde ao padrão de expressão regular. Esse valor é encontrado na propriedade id do objeto sender na carga 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 ou refs/tags/tag-name). Para um evento push, o nome de referência é encontrado na propriedade ref da carga webhook. Para eventos de solicitações pull, o nome da ramificação é encontrado na propriedade ref do objeto head 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 (por exemplo, refs/heads/branch-name). Um filtro BASE_REF pode ser usado apenas com eventos de solicitação pull. O nome da ramificação é encontrado na propriedade ref do objeto base na carga webhook.

FILE_PATH

Um evento de webhook aciona uma compilação quando o caminho de um arquivo alterado corresponde ao padrão das expressões regulares. Um FILE_PATH filtro pode ser usado com eventos de GitHub push e pull request e eventos push do GitHub Enterprise Server. Ele não pode ser usado com eventos de pull request do GitHub Enterprise Server.

nota

O FILE_PATH filtro é avaliado em relação aos primeiros 100 arquivos alterados em uma solicitação push ou pull. Para garantir que o filtro seja aplicado conforme o esperado, mantenha o número de arquivos alterados dentro desse limite. Para eventos de pull request, também recomendamos usar uma política de compilação de pull request para controlar quais pull requests podem iniciar uma compilação.

COMMIT_MESSAGE

Um webhook aciona uma compilação quando a mensagem de confirmação head corresponde à expressão padrão. Um COMMIT_MESSAGE filtro pode ser usado com eventos de GitHub push e pull request e eventos push do GitHub Enterprise Server. Ele não pode ser usado com eventos de pull request do GitHub Enterprise Server.

TAG_NAME

Um webhook aciona uma compilação quando o nome da tag da versão corresponde ao padrão de expressão regular. Um TAG_NAME filtro pode ser usado com eventos de solicitação GitHub lançados e pré-lançados.

RELEASE_NAME

Um webhook aciona uma compilação quando o nome da versão corresponde ao padrão da expressão regular. Um RELEASE_NAME filtro pode ser usado com eventos de solicitação GitHub lançados e pré-lançados.

REPOSITORY_NAME

Um webhook aciona uma compilação quando o nome do repositório corresponde ao padrão da expressão regular. Um REPOSITORY_NAME filtro só pode ser usado com GitHub webhooks globais ou organizacionais.

ORGANIZATION_NAME

Um webhook aciona uma compilação quando o nome da organização corresponde ao padrão da expressão regular. Um ORGANIZATION_NAME filtro só pode ser usado com GitHub webhooks globais.

WORKFLOW_NAME

Um webhook aciona uma compilação quando o nome do fluxo de trabalho corresponde ao padrão da expressão regular. Um WORKFLOW_NAME filtro pode ser usado com eventos de solicitação de trabalho em fila do fluxo de trabalho do GitHub Actions.

nota

Você pode encontrar a carga útil do webhook nas configurações do webhook do seu repositório. GitHub