View a markdown version of this page

Événements du webhook Bitbucket - AWS CodeBuild

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Événements du webhook Bitbucket

Vous pouvez utiliser des groupes de filtres webhook pour spécifier quels événements webhook Bitbucket déclenchent une génération. Par exemple, vous pouvez spécifier qu'une génération n'est déclenchée que pour les modifications apportées à des branches spécifiques.

Vous pouvez créer un ou plusieurs des groupes de filtres webhook pour spécifier les événements webhook qui déclenchent une génération. Une génération est déclenchée si un groupe de filtres est évalué à true, ce qui se produit lorsque tous les filtres du groupe sont évalués à true. Lorsque vous créez un groupe de filtres, vous spécifiez :

Un événement

Pour Bitbucket, vous pouvez choisir un ou plusieurs des événements suivants :

  • PUSH

  • PULL_REQUEST_CREATED

  • PULL_REQUEST_UPDATED

  • PULL_REQUEST_MERGED

  • PULL_REQUEST_CLOSED

Le type d’événement du webhook est situé dans son en-tête dans le champ X-Event-Key. Le tableau suivant présente le mappage des valeurs d’en-tête X-Event-Key aux types d’événements.

Note

Vous devez activer l'événement merged dans le paramètre de votre webhook Bitbucket si vous créez un groupe de filtres de webhook qui utilise le type d’événement PULL_REQUEST_MERGED. Vous devez également activer l'declinedévénement dans vos paramètres de webhook Bitbucket si vous créez un groupe de filtres de webhooks qui utilise le PULL_REQUEST_CLOSED type d'événement.

Valeur d'en-tête X-Event-Key Type d’événement
repo:push PUSH
pullrequest:created PULL_REQUEST_CREATED
pullrequest:updated PULL_REQUEST_UPDATED
pullrequest:fulfilled PULL_REQUEST_MERGED
pullrequest:rejected PULL_REQUEST_CLOSED

En PULL_REQUEST_MERGED effet, si une pull request est fusionnée avec la stratégie squash et que la branche pull request est fermée, le commit original de la pull request n'existe plus. Dans ce cas, la variable d'CODEBUILD_WEBHOOK_MERGE_COMMITenvironnement contient l'identifiant de la validation de fusion écrasée.

Un ou plusieurs filtres optionnels

Utilisez une expression régulière pour spécifier un filtre. Pour qu'un événement déclenche une génération, chaque filtre du groupe qui lui est associé doit être évalué comme vrai.

CodeBuild évalue les modèles de filtre à l'aide d'une syntaxe d'expression RE2 régulière, qui ne prend pas en charge le lookahead, le lookbehind, les références rétrospectives ou les groupes atomiques. Pour plus d'informations, consultez la page RE2 Syntaxe du GitHub site Web.

ACTOR_ACCOUNT_ID(ACTOR_IDdans la console)

Un événement webhook déclenche une génération lorsqu'un identifiant de compte Bitbucket correspond au modèle d'expression régulière. Cette valeur est disponible dans la propriété account_id de l'objet actor dans la charge utile de filtre du webhook.

HEAD_REF

Un événement webhook déclenche une génération lorsque la référence de tête correspond au modèle d'expression régulière (par exemple, refs/heads/branch-name etrefs/tags/tag-name). Un filtre HEAD_REF évalue le nom de la référence Git de la branche ou de la balise. Le nom de la branche ou de la balise est situé dans le champ name de l’objet new dans l’objet push de la charge utile du webhook. Pour des événements de demande d’extraction, le nom de la branche est situé dans le champ name de l'objet branch de l'objet source dans la charge utile du webhook.

BASE_REF

Un événement webhook déclenche une génération lorsque la référence de base correspond au modèle d'expression régulière. Un filtre BASE_REF fonctionne avec des événements de demande d'extraction uniquement (par exemple, refs/heads/branch-name). Un filtre BASE_REF évalue le nom de la référence Git de la branche. Le nom de la branche est situé dans le champ name de l'objet branch dans l'objet destination de la charge utile du webhook.

FILE_PATH

Un webhook déclenche une génération lorsque le chemin d'un fichier modifié correspond au modèle d'expression régulière.

Note

Le FILE_PATH filtre est évalué par rapport aux 3 000 premiers fichiers modifiés dans le cadre d'une requête push ou pull. Pour vous assurer que le filtre est appliqué comme prévu, maintenez le nombre de fichiers modifiés dans cette limite. Pour les événements de pull request, nous vous recommandons également d'utiliser une politique de génération de pull request pour contrôler quelles pull requests peuvent démarrer une génération.

COMMIT_MESSAGE

Un webhook déclenche une génération lorsque le message de validation principal correspond au modèle d'expression régulière.

WORKFLOW_NAME

Un webhook déclenche une génération lorsque le nom du flux de travail correspond au modèle d'expression régulière.

Note

Vous pouvez trouver la charge utile du webhook dans les paramètres webhook de votre référentiel Bitbucket.

Rubriques