機能ブランチの操作

サポートされているバージョン管理システム

Git と Mercurial の機能ブランチ、および Perforce の ブランチストリームサポート がサポートされています。

ブランチの構成

DVCS ブランチの使用を開始するには、ブランチ仕様を設定する必要があります。 これらの仕様は、変更を監視する必要があるブランチを指定します。

ブランチ仕様を構成すると、TeamCity はこれらのブランチの変更を監視し始めます。 ビルド構成に VCS トリガーがあり、いずれかのブランチで変更が検出された 場合、TeamCity はこのブランチでビルドをトリガーします。 ビルド構成のホームページから、ブランチ名で履歴のフィルタリング、変更ログ、保留中の変更、発行ログを行うこともできます。 ブランチ名はカスタムビルドダイアログにも表示されるため、ブランチでもカスタムビルドを手動でトリガーできます。

パイプラインの機能ブランチ

詳細については、 機能ブランチ ドキュメントを参照してください。

ブランチ固有のビルド構成設定

バージョン管理された設定を使用すると、リポジトリブランチごとに変数設定を含むビルド構成を作成できます。 例については、記事 ブランチ固有の設定を参照してください。

デフォルトブランチ

DVCS の VCS ルートを設定する場合、デフォルトとして使用するブランチ名を指定する必要があります。 デフォルトのブランチには特別な意味があります。

• これは、ブランチが指定されていない場合、または指定されたブランチがブランチ仕様に含まれていない場合（たとえば、誰かがブランチを選択せずに 実行 をクリックした場合）に使用するフォールバックブランチです。

• ビルドおよび変更のシーケンスを表示し、ブランチ作成の瞬間に到達するときに使用できます。

• デフォルトのブランチでは、スナップショットの依存関係によってリンクされている場合、異なる VCS ルート（たとえば、ルートの 1 つが Git で別のルートが Mercurial の場合）および異なるビルドで異なるブランチを使用できます。 最上位のチェーンビルドがデフォルトのブランチでトリガーされると、そのすべての依存関係もそれぞれのデフォルトのブランチでビルドされます。

ブランチフィルターで無効にしない限り、デフォルトのブランチは常に暗黙的にブランチ仕様に含まれます。 TeamCity UI では、デフォルトブランチはブランチマーカーの濃い背景で示されます。

自分のブランチ

TeamCity は、現在の TeamCity ユーザーのコミットに基づいて、ブランチを識別してグループ化できます。

ブランチフィルターで ブランチグループを選択すると、定義された VSC ユーザー名に基づいて、コミットが最後の 100 件の変更に含まれるすべてのアクティブブランチが表示されます。

論理ブランチお名前

論理ブランチ名は、ビルドのユーザーインターフェースおよびビルド構成レベルに表示されるブランチ名です。 論理ブランチ名は、通常、完全な VCS 固有のブランチ名の一部です。 これは、バージョン管理からのブランチ名に ブランチ仕様を適用することによって計算されます。

例: ブランチ仕様が次のように定義されている場合:

その場合、 * に一致する部分（たとえば マスター ）は論理的なブランチ名です。

ブランチ仕様パターンで丸括弧を使用している場合、論理お名前は丸括弧内のお名前の部分で構成されます。VCS ブランチ refs/heads/v8.1/feature1 について、 v8.1/feature1 論理お名前を UI に表示するには、これを使用します：

デフォルトのブランチは、すでに暗黙的に含まれているため、ブランチ仕様に含める必要はありません。 ただし、UI のデフォルトブランチの短い論理ブランチ名（たとえば、 マスター ）が必要な場合は、それをブランチ仕様に含めて、括弧を使用できます。

ビルド

次の 2 つの方法のいずれかで、特定のブランチでビルドを手動で実行できます。

• ビルドリストで必要なブランチの反対側にある 実行 をクリックします。

• カスタムランダイアログを開き、 変更 タブに移動して、「ブランチをビルドする 」ドロップダウンメニューから必要なブランチを選択します。

特定のブランチまたはブランチのセットからビルドを自動的に実行するには、 ビルドトリガーを構成します。

ブランチからのビルドは、特別なラベルでマークされるため、TeamCity UI で簡単に識別できます：

特定のブランチに関心がある場合は、ブランチ名で履歴をフィルタリングすることもできます。 TeamCity は、デフォルトブランチからのビルドにもブランチラベルを割り当てます。

変更

TeamCity は各ビルドについて、ビルドに含まれる変更を表示します。 ブランチからのビルドでは、変更の計算プロセスでブランチが考慮され、ビルドブランチに関連する変更が表示されます。 ブランチ内のビルドの変更は、ビルドのリビジョンから、同じブランチ内の前回のビルドまたはデフォルトブランチ内のビルドまでの変更として計算されます。
コミットのグラフを含む変更ログは、監視対象ブランチで何が起きているかを理解するのに役立ちます。

グラフを表示 オプションがデフォルトで有効化されている場合、TeamCity はグラフにビルドマーカーを表示します。

アクティブブランチ

ブランチが構成されたビルド構成では、ほとんどの UI ページにデフォルトでアクティブなブランチが表示されます。

アクティブブランチ とは、最近のアクティビティがあるブランチです。最近のビルドがあるか、最近のコミットを含むリポジトリに存在します。

アクティビティのしきい値は、ビルド構成パラメーターを介して構成できます。 パラメーターは、ビルド構成（1 つのビルド構成のみに影響します）、プロジェクト、 内部プロパティ （サーバー全体のデフォルトを定義します）のいずれかで変更できます。 構成内のパラメーターは、 内部プロパティ内のパラメーターをオーバーライドします。

ブランチは、次の場合にアクティブと見なされます。

• VCS リポジトリに存在し、最近のコミット（つまり、整数パラメーター teamcity.activeVcsBranch.age.days の値（デフォルトでは 7 日間）よりも経過日数の短いコミット）があります。

• または、最近のビルド (つまり、経過時間が整数パラメーター teamcity.activeBuildBranch.age.hours の値未満のビルド、デフォルトでは 24 時間) がある場合です。
  ビルドがある閉じた VCS ブランチは、最後のビルドから 24 時間は引き続きアクティブとして表示されます。 閉じたブランチを表示から除去するには、 teamcity.activeBuildBranch.age.hours=0 を設定します。

テスト

TeamCity はビルド内の新たに失敗したテストを検出しようとします。新しくないテストについては、そのテストがどのビルドで失敗し始めたかを確認できます。 この機能はブランチにも対応しています。つまり、最初のビルドが計算されるとき、TeamCity は同じブランチのビルドを全探索します。

さらに、テスト詳細ページでは ブランチフィルターが利用可能で、単一のブランチでテストの合格または不合格の履歴を確認できます。

失敗条件

ビルド失敗条件が次のように設定されている場合: 最後に成功/完了/固定されたビルドと比較してビルドメトリックが変更された 、TeamCity は現在のビルドを同じブランチのビルドと比較しようとします。 同じブランチに適切なビルドがない場合は、デフォルトのブランチからのビルドを使用し、それぞれのメッセージをビルドログに追加します。 現在、デフォルトブランチが ブランチフィルター によって無効化されている場合、TeamCity はビルド失敗条件を適切に処理できないことに注意してください (関連する課題 TW-74884 を参照)。

トリガー

VCS トリガーはブランチを完全に認識しており、チェックインがブランチで検出されるとビルドをトリガーします。 チェックインごとのトリガー、静止期間、トリガールールなど、すべての VCS トリガーオプションは、ブランチからのビルドで直接使用できます。 デフォルトでは、スケジュールおよび完了ビルドトリガーは、デフォルトのブランチでのビルドのみを監視します。

さらに、VCS、スケジュール、完了ビルドトリガーに ブランチフィルターを指定できます。

依存関係

ブランチを含むビルド構成に、ブランチを含む他のビルド構成へのスナップショット依存関係がある場合、ビルドの VCS ルートのブランチが同じ 論理名を持ち、このブランチが ブランチ仕様によって除外されていない場合、ブランチ内のビルドがトリガーされると、チェーン内の他のビルドにも関連付けられたブランチが取得されます。 ビルドの VCS ルートは異なるリポジトリを指すことができますが、論理ブランチ名は同じである必要があります。

この条件が満たされると、このお名前のブランチがチェックアウトされ、チェーンのダウン方向にあるすべてのビルド (トリガーされたビルドが依存するビルド) とチェーンのアップ方向にあるすべてのビルド (トリガーされたビルドに依存するビルド) が同じブランチでマークされます。 それ以外の場合、デフォルトブランチがチェックアウトされます。

特定のブランチのビルドからアーティファクトを取得するようにアーティファクト依存関係を構成できます。アーティファクト依存関係は、指定されたブランチのビルドを使用します。 同じことが スケジュール トリガーと ビルド完了 トリガーにも当てはまります。

通知

「私の変更」を除くすべての通知ルールは、デフォルトブランチからのビルドについてのみ通知します。 同時に、利用可能なすべてのブランチからのビルドに対して、「My changes」ルールが機能します。

ビルド構成ステータス

ビルド構成ステータスは、デフォルトのブランチからのビルドのみに基づいて計算されます。 構成ごとの調査は、デフォルトのブランチからのビルドに対して機能します。 例: デフォルト以外のブランチからのビルドが成功しても、構成ごとの調査は削除されませんが、デフォルトのブランチからのビルドが成功すると削除されます。

複数の VCS ルート

ビルド構成に、指定されたブランチフィルターを持つ 2 つ（またはそれ以上）の VCS ルートがある場合、トリガー動作はより複雑になる可能性があります。

VCS トリガーは、複数のルートからのブランチを 論理ブランチお名前 でグループ化します。 あるルートに他のルートからのブランチがない場合、そのデフォルトのブランチが使用されます。

例: 2 つの VCS ルートに同じデフォルトブランチ refs/heads/マスター があります。 Root1 にはブランチ仕様 refs/heads/7.1/* があり、ブランチ refs/heads/7.1/feature1 と refs/heads/7.1/feature2 に新しいコミットがあります。 Root2 には仕様 refs/heads/devel/* があり、ブランチ refs/heads/devel/feature1 に新しいコミットがあります。
ここで、 feature1 は、異なるパスを持つ二つのブランチ .../7.1/feature1 と .../devel/feature1 に関連する論理お名前です。

この場合、VCS トリガーは、次のブランチの組み合わせからのリビジョンで 3 つのビルドを実行します。

ビルドパラメーター

ビルドスクリプトでブランチ名を取得するか、他のビルド構成設定でパラメーターとして使用する必要がある場合は、 定義済みのビルドパラメーターを参照してください。

クリーンアップ

クリーンアップルールは、 アクティブなブランチごとに 個別に適用されます。

手動ブランチマージ

TeamCity ではブランチを手動でマージできます。たとえば、コードレビュー/承認後にのみブランチをマージしたい場合や、ブランチでテスト失敗があってもマージを実行したい場合です。

ソースを手動でマージする は:

ビルド結果ページ を開き、右上隅の アクション メニューをクリックして このビルドソースをマージする を選択します。
表示されるダイアログでは、宛先ブランチの選択とコミットメッセージ(必須)の追加が有効化されます。

ブランチを 自動でマージすることも可能です。