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: 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.
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 Pełna składnia pełnej kontroli.
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: 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łą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.

Ważne

Wyzwalacze żądania ściągnięcia YAML są obsługiwane tylko w usłudze GitHub. 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 .

Ważne

Po określeniu wyzwalacza żądania ściągnięcia tylko gałęzie jawnie skonfigurowane do dołączania wyzwalają potok. Dołączania są najpierw przetwarzane, a następnie wykluczenia są usuwane z tej listy. Jeśli określisz wykluczenie, ale nie dołączysz, nic nie wyzwala.

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.

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

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.

pr: gałęzie, ścieżki

Pełna składnia pełnej kontroli.

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.

Właściwości

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.

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.