触发器定义

项目
06/11/2024

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

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

引用此定义的定义：管道

实现形式

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

实现	描述
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。
要包括或排除以触发运行的标记名称。

触发器：批处理、分支、路径

使用完整语法控件可完全控制 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布尔值。
是否按分支批量更改。

branchesincludeExcludeFilters。
要包括或排除以触发运行的分支名称。

pathsincludeExcludeFilters。
要包含或排除以触发运行的文件路径。

注解

如果有许多团队成员经常上传更改，则可能需要减少启动的运行次数。如果将 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

另请参阅

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

通过