プッシュ トリガーは、継続的インテグレーション ビルドを実行する分岐を指定します。
この定義を参照する定義: パイプライン、resources.repositories.repository
実装
| 実装 | 形容 |
|---|---|
| トリガー: なし | CI トリガーを無効にします。 |
| トリガー: 文字列リストの | 実行をトリガーするブランチの一覧。 |
| トリガー: バッチ、分岐、パス、タグ | 完全な制御のための完全な構文。 |
備考
特定のリポジトリの種類でトリガーを使用する方法の詳細については、「サポートされているソース リポジトリ
プッシュ トリガーを指定しない場合は、任意のブランチにプッシュしてビルドをトリガーします。
[暗黙的な YAML CI トリガーの無効化] 設定が有効になっていない限り、YAML パイプラインはすべてのブランチで CI トリガーを使用して既定で構成されます。
暗黙的な YAML CI トリガー を無効にする設定は、組織レベルまたはプロジェクト レベルで構成できます。
暗黙的な YAML CI トリガー の無効化設定が有効になっている場合、YAML パイプラインに trigger セクションがない場合、YAML パイプラインの CI トリガーは有効になりません。
暗黙的な YAML CI トリガー を無効にするの既定値は falseです。
trigger キーワードには、含める分岐の一覧、CI トリガーを無効にする方法、完全な制御のための完全な構文の 3 つの構文オプションがあります。
exclude、include、または branchesに tags 句を指定せずに paths 句を指定する場合、* 句で 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を
実行をトリガーするために含めるか除外するタグ名です。
備考
多くのチーム メンバーが頻繁に変更をアップロードしている場合は、開始する実行の数を減らすことができます。
batch を trueに設定すると、パイプラインが実行されているときに、システムは実行が完了するまで待機し、まだビルドされていないすべての変更で別の実行を開始します。 既定では、batch は falseです。
分岐、タグ、またはパスを指定する場合は、正確な名前またはワイルドカードを使用できます。 詳細については、ワイルドカード
大事な
batch は、リポジトリ リソース トリガーではサポートされていません。
詳細については、「トリガー - CI トリガーの」を参照し、リポジトリの種類を選択します。
例
# Build every branch except for main
trigger:
branches:
include:
- '*' # Must enclose in '' since * is a reserved YAML character
exclude:
- main
# specific branch build with batching
trigger:
batch: true
branches:
include:
- main
trigger:
batch: true
branches:
include:
- features/*
exclude:
- features/experimental/*
paths:
exclude:
- README.md
関連項目
トリガー