觸發程式定義

發行項
11/20/2024

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

參考此定義的定義：管線、resources.repository.repository

參考此定義的定義：管線

實現

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

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

言論

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

如果您未指定推送觸發程式，則會推送至組建的任何分支觸發程式。

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

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

如果您 exclude 為 branches、tags或 paths指定 include 子句，則相當於在 include 子句中指定 *。

重要

當您指定觸發程式時，只有您明確設定以包含觸發管線的分支。先處理包含專案，然後從該清單中移除排除專案。如果您指定排除，但沒有包含專案，則不會觸發任何觸發程式。

觸發程式：無

停用 CI 觸發程式。

trigger: none # Disable CI triggers.

trigger 字串。允許的值：無。

停用 CI 觸發程式。

例子

trigger: none # will disable CI builds entirely

觸發程式：字串清單

觸發執行的分支清單。

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

清單類型

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

例子

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 布林值。
是否要針對每個分支批次變更。

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

paths includeExcludeFilters。
要包含或排除以觸發執行的檔案路徑。

tags includeExcludeFilters。
要包含或排除的標籤名稱以觸發執行。

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

使用完整的語法控件來完全控制 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.

性能

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

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

paths includeExcludeFilters。
要包含或排除以觸發執行的檔案路徑。

言論

如果您有許多小組成員經常上傳變更，您可能會想要減少您開始的執行次數。如果您將 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

另請參閱

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

共用方式為