pr 定義

提取要求觸發程式會指定哪些分支導致提取要求組建執行。

參考此定義的定義： 管線

實作

實作	描述
pr：無	停用提取要求觸發程式。
pr：字串清單	觸發執行的分支清單。
pr：autoCancel、分支、路徑、草稿	完整控制項的完整語法。

備註

如果您未指定提取要求觸發程式，則提取要求至任何分支會觸發組建。

關鍵字有三個不同的語法選項 pr ：要包含的分支清單、停用 PR 觸發程式的方法，以及完整控制的完整語法。

重要

只有在 GitHub 和 Bitbucket Cloud 中才支援 YAML PR 觸發程式。 如果您使用 Azure Repos Git，您可以設定組建驗證的分支原則，以觸發建置管線以進行驗證。

如果您為 或 指定 exclude 沒有 子句的 includebranches 子句，則相當於在 include 子句中指定 * 。 paths

pr：無

停用提取要求觸發程式。

pr: none # Disable pull request triggers.

pr 字串。 允許的值：無。

停用提取要求觸發程式。

範例

停用語法：

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

pr：字串清單

觸發執行的分支清單。

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

清單類型

類型	描述
字串	觸發執行的分支清單。

備註

清單語法會指定分支清單，這些分支會在引發提取要求時觸發執行，或對引發提取要求的來源分支進行推送。

範例

清單語法：

pr:
- main
- develop

pr：autoCancel、分支、路徑、草稿

當您需要完全控制提取要求觸發程式時，請使用完整的語法。

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.

屬性

autoCancel布林值。
當新的認可進入分支時，是否要取消執行中的 PR 組建。 預設：True。

branchesincludeExcludeFilters。
要包含或排除以觸發執行的分支名稱。

pathsincludeExcludeFilters。
要包含或排除以觸發回合的檔案路徑。

drafts布林值。
是否要在建立草稿 PR 時啟動執行。 預設：True。

範例

完整語法：

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

另請參閱

深入瞭解 提取要求觸發程式 ，以及如何指定它們。