触发器定义

项目
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 触发器的方法以及完整控制的完整语法。

如果为 excludebranches、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

另请参阅

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

通过