ブランチフィルター

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

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

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

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

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

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

ブランチフィルターのフォーマット

ブランチをフィルターするには、 +|-:論理_ブランチ_お名前 ルールの改行区切りリストを使用します。ここで、 論理_ブランチ_お名前 は TeamCity UI に表示されるお名前です (例: マスター)。 お名前では大文字と小文字が区別されます。

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

各ルールには、任意のワイルドカード * プレースホルダーをひとつ含めることができ、これはひとつ以上の文字に一致します: +|-:お名前* はブランチ お名前 1 に一致しますが、 しません はブランチ お名前 に一致しないため、明示的に追加する必要があります。

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

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

他の例:

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

  +:<default>

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

  +:* -:<default>

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

  +:feature-*

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

  +:*

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

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

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

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

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

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

• github_role — 送信者ロール（リポジトリ組織を基準）別にプル（マージ）リクエストをフィルタリングできます。 サポートされる値: コラボレーター、 コントリビューター、 メンバー、 所有者、 なし （大文字と小文字は区別されません）。

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