Freigeben über


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.
Implementierung Beschreibung
pr: keine Deaktivieren Sie Pull Request-Trigger.
pr: Zeichenfolgenliste Liste der Branches, die eine Ausführung auslösen.
pr: autoCancel, Branches, Pfade Vollständige Syntax für vollständige Kontrolle.
Implementierung Beschreibung
pr: keine Deaktivieren Sie Pull Request-Trigger.
pr: Zeichenfolgenliste Liste der Branches, die eine Ausführung auslösen.
pr: Branches, Pfade 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.

Wichtig

YAML PR-Trigger werden nur in GitHub 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.

Wichtig

Wenn Sie einen Pull Request-Trigger angeben, lösen nur Branches, die Sie explizit für die Aufnahme konfigurieren, eine Pipeline aus. Zuerst werden eingeschlossene Branches verarbeitet, dann werden ausgeschlossene Branches aus dieser Liste entfernt. Wenn Sie einen Ausschluss, aber keine Einschlüsse angeben, wird nichts ausgelöst.

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

pr: autoCancel, Branches, Pfade

Vollständige Syntax für vollständige Kontrolle.

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.

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.

pr: Branches, Pfade

Vollständige Syntax für vollständige Kontrolle.

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.

Eigenschaften

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.

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.