構成YAMLでのビルドトリガー

1 つの項目に複数のトリガー条件を定義した場合、ビルドをトリガーするにはすべての条件が一致する必要があります。例:

trigger_map:
- pull_request_target_branch: "main"
  pull_request_source_branch: "develop"
  type: pull_request
  workflow: primary

これにより、 primary プルリクエストのソースブランチが develop かつ、ターゲットブランチは main。

トリガーの順序は重要です。条件が一致する最初のトリガーがビルドをトリガーします。たとえば、コード プッシュ トリガーが 2 つあるとします。

trigger_map:
- type: push
  push_branch: main
  workflow: primary
- type: push
  commit_message: deploy
  workflow: deploy

最初のトリガーは primary コードがプッシュされた場合のワークフロー main アプリのリポジトリのブランチ。

2番目のトリガーは deploy コミットメッセージ付きのコミットの場合のワークフロー deploy リポジトリの任意のブランチにプッシュされます。

コミットがプッシュされると何が起こるか main コミットメッセージ付きのブランチ deploy? コミットは最初のトリガーのすべての条件に一致するので、 primary ワークフローがトリガーされます。このシナリオでは、 deploy コミットがそのトリガーのすべての条件に一致しているにもかかわらず、ワークフローはトリガーされません。

ワイルドカード（*）はトリガー内での単純なテキストマッチングに使用できます。ワイルドカードは、正規表現の高度なパターンマッチング機能を必要としない場合に適しています。たとえば、 fix ワイルドカードを使用して実現できます。

ワイルドカードは、入力に含まれる特定の固定値を一致させるのに役立ちます。複数の代替値、否定、特定の文字グループまたは特定の文字タイプ (たとえば、数字のみ) のキャプチャが必要な場合は、正規表現を使用することをお勧めします。

トリガー条件に正規表現を使用するには、 regex: 次の形式で値を入力します。

trigger_map:
- type: push
  push_branch:
    regex: <regular expression>
  workflow: primary
- type: pull_request
  pull_request_source_branch:
    regex: <regular expression>