Definicja żądania ściągnięcia

Wyzwalacz żądania ściągnięcia określa, które gałęzie powodują uruchomienie kompilacji żądania ściągnięcia.

Definicje odwołujące się do tej definicji: potok

Implementacje

Implementacja	Opis
pr: brak	Wyłącz wyzwalacze żądania ściągnięcia.
żądanie ściągnięcia: lista ciągów	Lista gałęzi, które wyzwalają przebieg.
pr: autoCancel, gałęzie, ścieżki, wersje robocze	Pełna składnia pełnej kontroli.

Uwagi

Jeśli nie określisz wyzwalacza żądania ściągnięcia, żądania ściągnięcia do dowolnej gałęzi wyzwalają kompilację.

Istnieją trzy różne opcje składni dla słowa kluczowego pr : lista gałęzi do uwzględnienia, sposób wyłączania wyzwalaczy żądania ściągnięcia i pełna składnia pełnej kontroli.

Ważne

Wyzwalacze żądania ściągnięcia YAML są obsługiwane tylko w usługach GitHub i Bitbucket Cloud. Jeśli używasz usługi Azure Repos Git, możesz skonfigurować zasady gałęzi na potrzeby weryfikacji kompilacji w celu wyzwolenia potoku kompilacji na potrzeby walidacji.

Jeśli określisz klauzulę exclude bez include klauzuli lub pathsbranches , jest ona równoważna określeniu * w klauzuli include .

pr: brak

Wyłącz wyzwalacze żądania ściągnięcia.

pr: none # Disable pull request triggers.

pr Ciąg. Dozwolone wartości: brak.

Wyłącz wyzwalacze żądania ściągnięcia.

Przykłady

Składnia wyłączania:

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

żądanie ściągnięcia: lista ciągów

Lista gałęzi, które wyzwalają przebieg.

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

Typy list

Typ	Opis
ciąg	Lista gałęzi, które wyzwalają przebieg.

Uwagi

Składnia listy określa listę gałęzi, które wyzwalają przebieg po wywołaniu żądania ściągnięcia lub wypchnięcie jest wykonywane do gałęzi źródłowej zgłoszonego żądania ściągnięcia.

Przykłady

Składnia listy:

pr:
- main
- develop

pr: autoCancel, gałęzie, ścieżki, wersje robocze

Użyj pełnej składni, gdy potrzebujesz pełnej kontroli nad wyzwalaczem żądania ściągnięcia.

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.

Właściwości

autoCancelwartość logiczna.
Czy anulować uruchomione kompilacje żądania ściągnięcia, gdy nowe zatwierdzenie zostanie wyświetlone w gałęzi . Wartość domyślna: true.

branchesincludeExcludeFilters.
Nazwy gałęzi do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

pathsincludeExcludeFilters.
Ścieżki plików do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

draftswartość logiczna.
Czy uruchamiać przebieg po utworzeniu roboczego żądania ściągnięcia. Wartość domyślna: true.

Przykłady

Pełna składnia:

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

Zobacz też

Dowiedz się więcej o wyzwalaczach żądań ściągnięcia i sposobach ich określania.