pr-definition

En utlösare för pull-begäran anger vilka grenar som gör att en pull-begäransversion körs.

Definitioner som refererar till den här definitionen: pipeline

Implementeringar

Genomförande	Beskrivning
pr: ingen	Inaktivera utlösare för pull-begäran.
pr:	Lista över grenar som utlöser en körning.
pr: autoCancel, grenar, sökvägar, utkast	Fullständig syntax för fullständig kontroll.

Anmärkningar

Om du inte anger någon utlösare för pull-begäran hämtar du begäranden till en grenutlösare.

Det finns tre olika syntaxalternativ för nyckelordet pr: en lista över grenar som ska inkluderas, ett sätt att inaktivera PR-utlösare och den fullständiga syntaxen för fullständig kontroll.

Viktigt!

YAML PR-utlösare stöds endast i GitHub och Bitbucket Cloud. Om du använder Azure Repos Git kan du konfigurera en grenprincip för byggverifiering för att utlösa bygg-pipelinen för validering.

Om du anger en exclude-sats utan en include-sats för branches eller paths, motsvarar det att ange * i include-satsen.

pr: ingen

Inaktivera utlösare för pull-begäran.

pr: none # Disable pull request triggers.

pr sträng. Tillåtna värden: ingen.

Inaktivera utlösare för pull-begäran.

Exempel

Inaktiveringssyntax:

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

pr: stränglista

Lista över grenar som utlöser en körning.

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

Listtyper

Typ	Beskrivning
sträng	Lista över grenar som utlöser en körning.

Anmärkningar

Listsyntaxen anger en lista över grenar som utlöser en körning när en pull-begäran genereras eller en push görs till källgrenen för en upphöjd pull-begäran.

Exempel

Listsyntax:

pr:
- main
- develop

pr: autoCancel, grenar, sökvägar, utkast

Använd den fullständiga syntaxen när du behöver fullständig kontroll över utlösaren för pull-begäran.

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.

Egenskaper

autoCancel boolesk.
Om du vill avbryta körningen av PR-versioner när en ny incheckning hamnar i grenen. Standard: sant.

branches includeExcludeFilters.
Grennamn som ska inkluderas eller exkluderas för att utlösa en körning.

paths includeExcludeFilters.
Filsökvägar som ska inkluderas eller exkluderas för att utlösa en körning.

drafts boolesk.
Om du vill starta en körning när ett utkast till pr skapas. Standard: sant.

Exempel

Fullständig syntax:

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

Se även

Läs mer om utlösare för pull-begäran och hur du anger dem.