ブランチフィルター

ブランチフィルターの使用箇所

現在、ブランチフィルターは、次の TeamCity 設定ページで構成できます。

単一のルートの上に複数のブランチフィルターが構成されている場合、次の優先順位が適用されます。

1. VCS ルート設定のブランチ仕様は、監視対象のブランチの初期セットを定義します。

2. 指定した場合、ビルド構成のバージョン管理設定のブランチフィルターは、ブランチの初期セットを絞り込むことができます。

3. 指定した場合、ビルドトリガーの設定でブランチフィルターが、フィルターによって宣言されたサブセットに適用されます（2）。

ブランチフィルター形式

ブランチをフィルタリングするには、+|-:logical_branch_name ルールの改改行コードリストを使用します。logical_branch_name は、TeamCity UI に表示される名前です（たとえば、master）。名前では大文字と小文字が区別されます。

+: ルールは、一致するブランチを受け入れられたブランチのリストに含め、-: ルールはブランチをリストから除外します。

各ルールには、1 つ以上の文字に一致するオプションのワイルドカード * プレースホルダーを 1 つ含めることができます。+|-:name* はブランチ name1 に一致しますが、明示的に追加する必要があるブランチ name には一致しません。

ブランチフィルターでパラメーター参照を使用できます。

単一のブランチがブランチフィルターの複数の行と一致する場合、最も具体的な（パターンと一致する最も少ない文字）最後の規則が適用されます。つまり、フィルターにブランチに一致する正確なパターン（つまり、* ワイルドカードのないパターン）が含まれている場合、最後のそのようなパターンが使用されます。

他の例:

• デフォルトのブランチのみが受け入れられます。

  +:<default>

• デフォルト以外のすべてのブランチが受け入れられます。

  +:* -:<default>

• feature- 接頭辞を持つブランチのみが受け入れられます

  +:feature-*

• 空のブランチフィルター（すべてのブランチが受け入れられます）:

  +:*

プルリクエストブランチフィルター

+|-pr: <parameter1>=<value1> <parameter2>=<value2> ... 構文を使用して、特定のプル (マージ) リクエストブランチを対象とするフィルターを作成します。この汎用構文を使用すると、論理的なブランチ名だけでなく、より具体的なパラメーターを考慮した、きめ細かい VCS に依存しないフィルター式を定義できます。

<parameter>=<value> 式は論理 AND 演算子を使用して結合されます。つまり、プル (マージ) リクエストブランチがフィルターを通過するにはすべての条件を満たす必要があります。現在、次のパラメーターと値がサポートされています。

• target および source — 受信および送信ブランチでリクエストをフィルターできます。リクエストがフォークされたリポジトリから発信された場合、source パラメーターは常に false になります。サポートされる値: オプションのワイルドカードを含む論理ブランチ名。

• sourceRepo — 同じリポジトリ (たとえば、1 つのリポジトリブランチを別のリポジトリにマージする場合)、フォークされたリポジトリ、その両方からのプルリクエストのみを対象にすることができます。サポートされる値: same、fork、any

• draft — ドラフトプルリクエストを受け入れるかどうかを指定します。このパラメーターは、GitHub と GitLab に対してのみ有効です。サポートされている値: ドラフトとしてラベル付けされたリクエストのみを受け入れる場合は true、非ドラフトリクエストのみを受け入れる場合は false

• github_role — 送信者ロール（リポジトリ組織を基準）別にプル（マージ）リクエストをフィルタリングできます。サポートされる値: collaborator、contributor、member、owner、none （大文字と小文字は区別されません）。

ブランチフィルターを設定するときは、マジックワンドボタンをクリックし、プルリクエスト条件タブに切り替えて、ビジュアルエディターを使用してフィルター式を追加します。