Udostępnij za pośrednictwem


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: potoku

Implementacje

Implementacja Opis
pr: brak Wyłącz wyzwalacze żądań ściągnięcia.
pr: 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.
Implementacja Opis
pr: brak Wyłącz wyzwalacze żądań ściągnięcia.
pr: lista ciągów Lista gałęzi, które wyzwalają przebieg.
pr: autoCancel, gałęzie, ścieżki 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łączenia 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 wyzwalać potok kompilacji na potrzeby walidacji.

Jeśli określisz klauzulę exclude bez klauzuli include dla branches lub paths, jest to równoważne określeniu * w klauzuli include.

pr: brak

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

pr: none # Disable pull request triggers.

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

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

Przykłady

Składnia wyłączenia:

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

pr: lista ciągów

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

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

Typy list

Typ Opis
sznurek 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ęciu 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 wyzwalacza żą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

autoCancel wartość logiczna.
, czy anulować uruchamianie kompilacji żądania ściągnięcia, gdy nowe zatwierdzenie zostanie wyświetlone w gałęzi. Wartość domyślna: true.

branches includeExcludeFilters.
nazwy gałęzi do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

paths includeExcludeFilters.
ścieżki plików do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

drafts wartość logiczna.
, czy należy uruchomić przebieg po utworzeniu roboczego żądania ściągnięcia. Wartość domyślna: true.

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

Pełna składnia pełnej kontroli.

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.

Właściwości

autoCancel wartość logiczna.
, czy anulować uruchamianie kompilacji żądania ściągnięcia, gdy nowe zatwierdzenie zostanie wyświetlone w gałęzi. Wartość domyślna: true.

branches includeExcludeFilters.
nazwy gałęzi do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

paths includeExcludeFilters.
ścieżki plików do uwzględnienia lub wykluczenia w celu wyzwolenia przebiegu.

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 żądania ściągnięcia i sposobach ich określania.