機能ブランチを使用した作業

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

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

ブランチの設定

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

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

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

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

デフォルトブランチ

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

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

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

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

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

ブランチ

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

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

論理ブランチ名

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

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

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

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

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

ビルド

次の 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/master があります。Root1 にはブランチ仕様 refs/heads/7.1/* があり、ブランチ refs/heads/7.1/feature1 と refs/heads/7.1/feature2 に新しいコミットがあります。Root2 には仕様 refs/heads/devel/* があり、ブランチ refs/heads/devel/feature1 に新しいコミットがあります。
ここで、feature1 は、異なるパスを持つ 2 つのブランチに関連する論理名です。.../7.1/feature1 と .../devel/feature1

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

ビルドパラメーター

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

掃除

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

手動ブランチマージ

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

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

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

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