触发器定义

推送触发器指定哪些分支会导致持续集成生成运行。

引用此定义的定义： pipeline、 resources.repositories.repository

实现形式

实现	描述
trigger： none	禁用 CI 触发器。
trigger：字符串列表	触发运行的分支列表。
触发器：批处理、分支、路径、标记	完整控件的完整语法。

注解

有关将触发器用于特定存储库类型的详细信息，请参阅 支持的源存储库。

默认情况下，YAML 管道在所有分支上使用 CI 触发器进行配置，除非启用了 禁用隐式 YAML CI 触发器 设置。 可以在组织级别或项目级别配置 禁用隐式 YAML CI 触发器 设置。 启用 “禁用隐式 YAML CI 触发器 ”设置后，如果 YAML 管道没有 trigger 部分，则不会启用 YAML 管道的 CI 触发器。 禁用隐式 YAML CI 触发器的默认值为 false。

trigger 关键字有三种不同的语法选项：要包括的分支列表、禁用 CI 触发器的方法以及用于实现完全控制的完整语法。

如果指定 exclude 子句而不包含 branches、tags 或 paths 的 include 子句，则等同于在 include 子句中指定 *。

trigger： none

禁用 CI 触发器。

trigger: none # Disable CI triggers.

trigger 字符串。 允许的值：无。

禁用 CI 触发器。

示例

trigger: none # will disable CI builds entirely

trigger：字符串列表

触发运行的分支列表。

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

列表类型

类型	说明
string	触发运行的分支列表。

示例

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

另请参阅

详细了解触发器以及如何指定。