次の方法で共有

トリガー定義

  • [アーティクル]

プッシュ トリガーは、継続的インテグレーション ビルドを実行する分岐を指定します。

この定義を参照する定義: パイプライン、resources.repositories.repository

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

実装

実装 形容
トリガー: なし CI トリガーを無効にします。
トリガー: 文字列リストの 実行をトリガーするブランチの一覧。
トリガー: バッチ、分岐、パス、タグ 完全な制御のための完全な構文。
実装 形容
トリガー: なし CI トリガーを無効にします。
トリガー: 文字列リストの 実行をトリガーするブランチの一覧。
トリガー: バッチ、分岐、パス 完全な制御のための完全な構文。

備考

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

プッシュ トリガーを指定しない場合は、任意のブランチにプッシュしてビルドをトリガーします。

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

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

branches、tags、または pathsに include 句を指定せずに exclude 句を指定する場合、include 句で * を指定することと同じです。

大事な

トリガーを指定すると、インクルージョン用に明示的に構成した分岐のみがパイプラインをトリガーします。 包含が最初に処理され、その後、その一覧から除外が削除されます。 除外を指定しても包含を指定しない場合、何もトリガーされません。

trigger: none

CI トリガーを無効にします。

trigger: none # Disable CI triggers.

trigger 文字列。 使用できる値: なし。

CI トリガーを無効にします。

例

trigger: none # will disable CI builds entirely

trigger: string list

実行をトリガーするブランチの一覧。

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

リストの種類

種類 形容
糸 実行をトリガーするブランチの一覧。

例

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.

プロパティ

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

includeExcludeFiltersを します。
実行をトリガーするために含めるか除外するブランチ名。

includeExcludeFiltersを します。
実行をトリガーするために含めるか除外するファイル パスです。

includeExcludeFiltersを します。
実行をトリガーするために含めるか除外するタグ名です。

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.

プロパティ

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

includeExcludeFiltersを します。
実行をトリガーするために含めるか除外するブランチ名。

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

関連項目

トリガー の詳細と、それらを指定する方法について説明します。