トリガー定義

プッシュ トリガーは、継続的インテグレーション ビルドを実行する原因となるブランチを指定します。

この定義を参照する定義: pipeline、 resources.repositories.repository

実装

実装	説明
trigger: none	CI トリガーを無効にします。
trigger: 文字列リスト	実行をトリガーするブランチの一覧。
trigger: batch, branchs, paths, tags	完全な制御のための完全な構文。

注釈

特定のリポジトリの種類でトリガーを使用する方法の詳細については、「 サポートされているソース リポジトリ」を参照してください。

[暗黙的な YAML CI トリガーを無効にする ] 設定が有効になっていない限り、YAML パイプラインはすべてのブランチで CI トリガーを使用して既定で構成されます。 [暗黙的な YAML CI トリガーを無効にする] 設定は、organization レベルまたはプロジェクト レベルで構成できます。 [暗黙的な YAML CI トリガーを無効にする] 設定が有効になっている場合、YAML パイプラインにセクションがない場合、YAML パイプラインの trigger CI トリガーは有効になりません。 [ 暗黙的な YAML CI トリガーを無効にする] の既定値は です false。

trigger キーワードには、3 つの異なる構文オプションがあります: 含めるブランチのリスト、CI トリガーを無効にする方法、完全な制御のための完全な構文。

branches、tags、または paths に対して include 句を指定せずに exclude 句を指定することは、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

trigger: batch, branchs, paths, tags

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.

プロパティ

batchboolean。
ブランチごとに変更をバッチ処理するかどうか。

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

関連項目

トリガーとその指定方法の詳細を理解してください。