définition pr

Un déclencheur de demande de tirage spécifie les branches qui entraînent l’exécution d’une build de demande de tirage.

Définitions qui font référence à cette définition : pipeline

Implémentations

Implémentation	Description
pr : none	Désactivez les déclencheurs de demande de tirage.
pr : liste de chaînes	Liste des branches qui déclenchent une exécution.
pr : autoCancel, branches, chemins, brouillons	Syntaxe complète pour un contrôle complet.

Notes

Si vous ne spécifiez aucun déclencheur de demande de tirage, les demandes de tirage à n’importe quelle branche déclenchent une build.

Il existe trois options de syntaxe distinctes pour le pr mot clé : une liste de branches à inclure, un moyen de désactiver les déclencheurs de demande de tirage et la syntaxe complète pour un contrôle complet.

Important

Les déclencheurs YAML PR sont pris en charge uniquement dans GitHub et Bitbucket Cloud. Si vous utilisez Azure Repos Git, vous pouvez configurer une stratégie de branche pour la validation de build afin de déclencher votre pipeline de build pour validation.

Si vous spécifiez une exclude clause sans include clause pour branches ou paths, cela équivaut à spécifier * dans la include clause .

pr : none

Désactivez les déclencheurs de demande de tirage.

pr: none # Disable pull request triggers.

pr String. Valeurs autorisées : aucune.

Désactivez les déclencheurs de demande de tirage.

Exemples

Syntaxe de désactivation :

pr: none # will disable PR builds (but not CI builds)

pr : liste de chaînes

Liste des branches qui déclenchent une exécution.

pr: [ string ] # List of branches that trigger a run.

Types de liste

Type	Description
string	Liste des branches qui déclenchent une exécution.

Notes

La syntaxe de liste spécifie une liste de branches qui déclenchent une exécution lorsqu’une demande de tirage est déclenchée ou qu’un envoi push est effectué vers la branche source d’une demande de tirage levée.

Exemples

Syntaxe de liste :

pr:
- main
- develop

pr : autoCancel, branches, chemins, brouillons

Utilisez la syntaxe complète lorsque vous avez besoin d’un contrôle total du déclencheur de demande de tirage.

pr:
  autoCancel: boolean # Whether to cancel running PR builds when a new commit lands in the branch. Default: true.
  branches: # Branch names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  paths: # File paths to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.
  drafts: boolean # Whether to start a run when a draft PR is created. Default: true.

Propriétés

autoCancelbooléen.
Indique s’il faut annuler les builds de pr en cours d’exécution lorsqu’un nouveau commit arrive dans la branche. Valeur par défaut : true.

branchesincludeExcludeFilters.
Noms de branche à inclure ou à exclure pour déclencher une exécution.

pathsincludeExcludeFilters.
Chemins de fichiers à inclure ou à exclure pour déclencher une exécution.

draftsbooléen.
Indique s’il faut démarrer une exécution lors de la création d’un brouillon de demande de tirage. Valeur par défaut : true.

Exemples

Syntaxe complète :

pr:
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

Voir aussi

En savoir plus sur les déclencheurs de demande de tirage et comment les spécifier.