トリガー定義

  • [アーティクル]

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

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

この定義を参照する定義: パイプライン

実装

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

注釈

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

プッシュ トリガーを指定しないと、任意のブランチへのプッシュでビルドがトリガーされます。

[暗黙的な 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。
実行をトリガーするために含める、または除外するタグ名。

trigger: batch, branchs, paths

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.

プロパティ

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

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

関連項目

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