Delen via


pr-definitie

Een pull-aanvraagtrigger geeft aan welke vertakkingen ervoor zorgen dat een pull-aanvraagbuild wordt uitgevoerd.

Definities die naar deze definitie verwijzen: pijplijn

Implementaties

Implementatie Beschrijving
pr: geen Triggers voor pull-aanvragen uitschakelen.
pr: tekenreekslijst Lijst met vertakkingen die een uitvoering activeren.
pr: autoCancel, vertakkingen, paden, concepten Volledige syntaxis voor volledig beheer.
Implementatie Beschrijving
pr: geen Triggers voor pull-aanvragen uitschakelen.
pr: tekenreekslijst Lijst met vertakkingen die een uitvoering activeren.
pr: autoCancel, vertakkingen, paden Volledige syntaxis voor volledig beheer.
Implementatie Beschrijving
pr: geen Triggers voor pull-aanvragen uitschakelen.
pr: tekenreekslijst Lijst met vertakkingen die een uitvoering activeren.
pr: vertakkingen, paden Volledige syntaxis voor volledig beheer.

Opmerkingen

Als u geen pull-aanvraagtrigger opgeeft, activeren pull-aanvragen voor elke vertakking een build.

Er zijn drie verschillende syntaxisopties voor het pr trefwoord: een lijst met vertakkingen die moeten worden opgenomen, een manier om PULL-triggers uit te schakelen en de volledige syntaxis voor volledig beheer.

Belangrijk

YAML PR-triggers worden alleen ondersteund in GitHub en Bitbucket Cloud. Als u Git azure-opslagplaatsen gebruikt, kunt u een vertakkingsbeleid configureren voor buildvalidatie om uw build-pijplijn te activeren voor validatie.

Belangrijk

YAML PR-triggers worden alleen ondersteund in GitHub. Als u Git azure-opslagplaatsen gebruikt, kunt u een vertakkingsbeleid configureren voor buildvalidatie om uw build-pijplijn te activeren voor validatie.

Als u een exclude component opgeeft zonder een include component voor branches of paths, is dit gelijk aan het opgeven * in de include component.

Belangrijk

Wanneer u een pull-aanvraagtrigger opgeeft, activeren alleen vertakkingen die u expliciet configureert voor opname een pijplijn. Insluitingen worden eerst verwerkt en vervolgens worden uitsluitingen uit die lijst verwijderd. Als u een uitsluiting opgeeft, maar geen insluitingen, wordt er niets geactiveerd.

pr: geen

Triggers voor pull-aanvragen uitschakelen.

pr: none # Disable pull request triggers.

pr Tekenreeks. Toegestane waarden: geen.

Triggers voor pull-aanvragen uitschakelen.

Voorbeelden

Syntaxis voor uitschakelen:

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

pr: tekenreekslijst

Lijst met vertakkingen die een uitvoering activeren.

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

Lijsttypen

Type Description
tekenreeks Lijst met vertakkingen die een uitvoering activeren.

Opmerkingen

De lijstsyntaxis geeft een lijst met vertakkingen op die een uitvoering activeren wanneer een pull-aanvraag wordt gegenereerd of een push wordt uitgevoerd naar de bronbranch van een verhoogde pull-aanvraag.

Voorbeelden

Lijstsyntaxis:

pr:
- main
- develop

pr: autoCancel, vertakkingen, paden, concepten

Gebruik de volledige syntaxis wanneer u volledige controle over de pull-aanvraagtrigger nodig hebt.

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.

Eigenschappen

autoCancelBooleaanse waarde.
Of actieve pull-builds moeten worden geannuleerd wanneer een nieuwe doorvoer in de vertakking terechtkomt. Standaard: waar.

branchesincludeExcludeFilters.
Namen van vertakkingen die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

pathsincludeExcludeFilters.
Bestandspaden die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

draftsBooleaanse waarde.
Of een uitvoering moet worden gestart wanneer een concept-pull-aanvraag wordt gemaakt. Standaard: waar.

pr: autoCancel, vertakkingen, paden

Volledige syntaxis voor volledig beheer.

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.

Eigenschappen

autoCancelBooleaanse waarde.
Of actieve pull-builds moeten worden geannuleerd wanneer een nieuwe doorvoer in de vertakking terechtkomt. Standaard: waar.

branchesincludeExcludeFilters.
Namen van vertakkingen die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

pathsincludeExcludeFilters.
Bestandspaden die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

pr: vertakkingen, paden

Volledige syntaxis voor volledig beheer.

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.

Eigenschappen

branchesincludeExcludeFilters.
Namen van vertakkingen die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

pathsincludeExcludeFilters.
Bestandspaden die moeten worden opgenomen of uitgesloten voor het activeren van een uitvoering.

Voorbeelden

Volledige syntaxis:

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

Zie ook

Meer informatie over pull-aanvraagtriggers en hoe u deze opgeeft.