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.
GitHub événements Webhook
Vous pouvez utiliser des groupes de filtres Webhook pour spécifier quels événements GitHub Webhook 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 GitHub, vous pouvez choisir un ou plusieurs des événements suivants :
PUSHPULL_REQUEST_CREATEDPULL_REQUEST_UPDATED,PULL_REQUEST_REOPENED,PULL_REQUEST_MERGED,PULL_REQUEST_CLOSED,RELEASEDPRERELEASED, etWORKFLOW_JOB_QUEUED. Le type d’événement du webhook est situé dans l’en-têteX-GitHub-Eventde la charge utile du webhook. Dans l’en-têteX-GitHub-Event, vous pourriez voirpull_requestoupush. Pour un événement de demande d’extraction, le type se situe dans le champactionde la charge utile d’événement du webhook. Le tableau suivant présente le mappage des valeurs de l’en-têteX-GitHub-Eventet des valeurs du champactionde la charge utile de la demande d’extraction du webhook aux types d’événements disponibles.Valeur d'en-tête X-GitHub-EventValeur actionde la charge utile de l’événement du webhookType d’événement pull_requestopenedPULL_REQUEST_CREATEDpull_requestreopenedPULL_REQUEST_REOPENEDpull_requestsynchronizePULL_REQUEST_UPDATEDpull_requestclosedet le champmergedesttruePULL_REQUEST_MERGEDpull_requestclosedet le champmergedestfalsePULL_REQUEST_CLOSEDpushn/a PUSHreleasepublié RELEASEDreleaseprépublié PRERELEASEDworkflow_jobqueued WORKFLOW_JOB_QUEUEDNote
Le type d'
PULL_REQUEST_REOPENEDévénement ne peut être utilisé qu'avec GitHub GitHub Enterprise Server. Le typePRERELEASEDd'événementRELEASEDet ne peut être utilisé GitHub qu'avec. Pour plus d’informations surWORKFLOW_JOB_QUEUED, consultez Tutoriel : Configuration d'un lanceur d' CodeBuild-hosted GitHub actions. - 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 ID de compte GitHub ou GitHub Enterprise Server correspond au modèle d'expression régulière. Cette valeur se situe dans la propriété
idde l’objetsenderdans la charge utile 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-nameourefs/tags/tag-name). Pour un événement d’extraction, le nom de référence est situé dans la propriétérefde la charge utile du webhook. Pour les événements de demande d’extraction, le nom de la branche est situé dans la propriétérefde l’objetheaddans 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 (par exemple,
refs/heads/branch-name). Un filtreBASE_REFne peut être utilisé qu’avec des événements de demande d’extraction. Le nom de la branche se situe dans la propriétérefde l’objetbasedans 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'expressions régulières. Un
FILE_PATHfiltre peut être utilisé pour les événements de demande GitHub push et pull et les événements push GitHub d'Enterprise Server. Il ne peut pas être utilisé avec les événements de pull request d' GitHubEnterprise Server.Note
Le
FILE_PATHfiltre est évalué par rapport aux 100 premiers fichiers modifiés dans 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. Un
COMMIT_MESSAGEfiltre peut être utilisé pour les événements de demande GitHub push et pull et les événements push GitHub d'Enterprise Server. Il ne peut pas être utilisé avec les événements de pull request d' GitHubEnterprise Server. TAG_NAME-
Un webhook déclenche une génération lorsque le nom de la balise de la version correspond au modèle d'expression régulière. Un
TAG_NAMEfiltre peut être utilisé pour les événements de demande GitHub publiés et prépubliés. RELEASE_NAME-
Un webhook déclenche une compilation lorsque le nom de la version correspond au modèle d'expression régulière. Un
RELEASE_NAMEfiltre peut être utilisé pour les événements de demande GitHub publiés et prépubliés. REPOSITORY_NAME-
Un webhook déclenche une génération lorsque le nom du référentiel correspond au modèle d'expression régulière. Un
REPOSITORY_NAMEfiltre ne peut être utilisé qu'avec des webhooks GitHub globaux ou organisationnels. ORGANIZATION_NAME-
Un webhook déclenche une génération lorsque le nom de l'organisation correspond au modèle d'expression régulière. Un
ORGANIZATION_NAMEfiltre ne peut être utilisé qu'avec des webhooks GitHub globaux. 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. Un
WORKFLOW_NAMEfiltre peut être utilisé pour les événements de demande de travail en file d'attente du flux de travail GitHub Actions.
Note
Vous pouvez trouver la charge utile du webhook dans les paramètres du webhook de votre référentiel. GitHub
Rubriques
