définition pr

Un déclencheur de demande de tirage spécifie les branches qui provoquent 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	Descriptif
pr : aucun	Désactivez les déclencheurs de demande de tirage.
pr : de liste de chaînes	Liste des branches qui déclenchent une exécution.
pr : autoCancel, branches, chemins, brouillons	Syntaxe complète pour le contrôle complet.

Remarques

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 mot clé pr : une liste de branches à inclure, un moyen de désactiver les déclencheurs de demande de tirage et la syntaxe complète pour le 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 pour déclencher votre pipeline de build pour la validation.

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

pr : aucun

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

pr: none # Disable pull request triggers.

chaîne pr. 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 listes

Catégorie	Descriptif
ficelle	Liste des branches qui déclenchent une exécution.

Remarques

La syntaxe de liste spécifie une liste de branches qui déclenchent une exécution lorsqu’une demande de tirage (pull request) est déclenchée ou qu’un envoi (push) est effectué vers la branche source d’une demande de tirage déclenché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

autoCancel booléen .
s’il faut annuler les builds de tirage en cours d’exécution lorsqu’une nouvelle validation atterrit dans la branche. Valeur par défaut : true.

branches includeExcludeFilters.
noms de branche à inclure ou exclure pour déclencher une exécution.

paths includeExcludeFilters.
chemins d’accès aux fichiers à inclure ou exclure pour déclencher une exécution.

drafts boolé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 déclencheurs de demande de tirage (pull request) et comment les spécifier.