pr definition

Ein Pull Request-Trigger gibt an, welche Branches bewirken, dass ein Pull Request-Build ausgeführt wird.

Definitionen, die auf diese Definition verweisen: Pipeline

Implementierungen

Implementierung	Beschreibung
pr: keine	Deaktivieren Sie Pull Request-Trigger.
pr: Zeichenfolgenliste	Liste der Branches, die eine Ausführung auslösen.
pr: autoCancel, Branches, Pfade, Entwürfe	Vollständige Syntax für vollständige Kontrolle.

Bemerkungen

Wenn Sie keinen Pull Request-Trigger angeben, lösen an einen beliebigen Branch gerichtete Pull Requests einen Build aus.

Es gibt drei unterschiedliche Syntaxoptionen für das pr-Schlüsselwort: eine Liste der einzuschließenden Branches, eine Möglichkeit zum Deaktivieren von PR-Triggern und die vollständige Syntax für die vollständige Steuerung.

Wichtig

YAML PR-Trigger werden nur in GitHub und Bitbucket-Cloud unterstützt. Wenn Sie Azure Repos Git verwenden, können Sie eine Branchrichtlinie für die Buildüberprüfung konfigurieren, um Ihre Buildpipeline zur Überprüfung auszulösen.

Wenn Sie eine exclude-Klausel ohne eine include-Klausel für branches oder paths angeben, ist dies gleichbedeutend mit der Angabe von * in der include-Klausel.

pr: keine

Deaktivieren Sie Pull Request-Trigger.

pr: none # Disable pull request triggers.

pr Schnur. Zulässige Werte: keine.

Deaktivieren Sie Pull Request-Trigger.

Beispiele

Deaktivierungssyntax:

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

pr: Zeichenfolgenliste

Liste der Branches, die eine Ausführung auslösen.

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

Listentypen

type	Beschreibung
Zeichenfolge	Liste der Branches, die eine Ausführung auslösen.

Bemerkungen

Die Listensyntax gibt eine Liste von Branches an, die eine Ausführung auslösen, wenn ein Pull Request ausgelöst oder ein Push an den Quellbranch eines ausgelösten Pull Requests ausgeführt wird.

Beispiele

Listensyntax:

pr:
- main
- develop

pr: autoCancel, Branches, Pfade, Entwürfe

Verwenden Sie die vollständige Syntax, wenn Sie die vollständige Kontrolle über den Pull Request-Trigger benötigen.

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.

Eigenschaften

autoCancelBoolesch.
Gibt an, ob ausgeführte PR-Builds abgebrochen werden sollen, wenn ein neuer Commit im Branch landet. Standardwert: TRUE

branchesincludeExcludeFilters.
Branchnamen, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

pathsincludeExcludeFilters.
Dateipfade, die zum Auslösen einer Ausführung eingeschlossen oder ausgeschlossen werden sollen.

draftsBoolesch.
Gibt an, ob eine Ausführung gestartet werden soll, wenn ein Entwurfs-PR erstellt wird. Standardwert: TRUE

Beispiele

Vollständige Syntax:

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

Weitere Informationen

Erfahren Sie mehr über Pull Request-Trigger und deren Angabe.