Partager via


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.
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 Syntaxe complète pour un contrôle complet.
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 : branches, chemins d’accès 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.

Important

Les déclencheurs DE PR YAML sont pris en charge uniquement dans GitHub. 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 .

Important

Lorsque vous spécifiez un déclencheur de demande de tirage, seules les branches que vous configurez explicitement pour l’inclusion déclenchent un pipeline. Les inclusions sont traitées en premier, puis les exclusions sont supprimées de cette liste. Si vous spécifiez une exclusion mais aucune inclusion, rien ne se déclenche.

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.

pr : autoCancel, branches, chemins

Syntaxe complète pour un contrôle complet.

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.

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.

pr : branches, chemins d’accès

Syntaxe complète pour un contrôle complet.

pr:
  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.

Propriétés

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.

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.