觸發程式定義

推送觸發程式會指定哪些分支會導致持續整合組建執行。

參考此定義的定義： pipeline、 resources.repository.repository

實作

實作	描述
觸發程式：無	停用 CI 觸發程式。
觸發程式：字串清單	觸發執行的分支清單。
觸發程式：批次、分支、路徑、標籤	完整控制項的完整語法。

備註

如需搭配特定存放庫類型使用觸發程式的詳細資訊，請參閱 支援的來源存放庫。

除非啟用停用 隱含 YAML CI 觸發 程式設定，否則 YAML 管線預設會在所有分支上使用 CI 觸發程式來設定。 您可以在組織層級或專案層級設定 [停用隱含 YAML CI 觸發程式 ] 設定。 啟用 [停用隱含 YAML CI 觸發程式 ] 設定時，如果 YAML 管線沒有 trigger 區段，則不會啟用 YAML 管線的 CI 觸發程式。 停用隱含 YAML CI 觸發程式的預設值為 false 。

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

如果您為 、 或 指定不含 子句的 include 子句 branches ，則相當於在 include 子句中指定 * 。 excludepathstags

觸發程式：無

停用 CI 觸發程式。

trigger: none # Disable CI triggers.

trigger 字串。 允許的值：無。

停用 CI 觸發程式。

範例

trigger: none # will disable CI builds entirely

觸發程式：字串清單

觸發執行的分支清單。

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

清單類型

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

範例

trigger:
- main
- develop

觸發程式：批次、分支、路徑、標籤

使用完整的語法控制項來完全控制 CI 觸發程式。

trigger:
  batch: boolean # Whether to batch changes per branch.
  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.
  tags: # Tag names to include or exclude for triggering a run.
    include: [ string ] # List of items to include.
    exclude: [ string ] # List of items to exclude.

屬性

batch布林值。
是否要針對每個分支批次變更。

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

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

tagsincludeExcludeFilters。
要包含或排除以觸發回合的標記名稱。

備註

如果您有許多小組成員經常上傳變更，您可能會想要減少您啟動的執行次數。 如果您設定 batch 為 true ，當管線正在執行時，系統會等到執行完成，然後啟動另一個執行，且所有尚未建置的變更。 根據預設， batch 為 false 。

重要

batch 存放 庫資源 觸發程式不支援。

如需詳細資訊，請參閱 觸發程式 - CI 觸發程式 並選擇您的存放庫類型。

# specific branch build with batching
trigger:
  batch: true
  branches:
    include:
    - main

範例

trigger:
  batch: true
  branches:
    include:
    - features/*
    exclude:
    - features/experimental/*
  paths:
    exclude:
    - README.md

另請參閱

深入瞭解 觸發程式和 如何指定觸發程式。