É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 construction 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é comme vrai, ce qui se produit lorsque tous les filtres du groupe sont évalués comme vrais. 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 webhook utilisant 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 de la pull request d'origine n'existe plus. Dans ce cas, la variable d'CODEBUILD_WEBHOOK_MERGE_COMMITenvironnement contient l'identifiant du commit de fusion écrasé.

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 avoir la valeur true.

ACTOR_ACCOUNT_ID(ACTOR_IDdans la console)

Un événement webhook déclenche une compilation 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 construction lorsque la référence principale 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 construction 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 compilation lorsque le chemin d'un fichier modifié correspond au modèle d'expression régulière.

COMMIT_MESSAGE

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

WORKFLOW_NAME

Un webhook déclenche une compilation 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.