ビルド コントローラーの配置および構成

Team Foundation ビルドを使用するには、軽量タスクを実行し、プロセッサ負荷の高いビルド処理をビルド エージェントのプールに分散させるためのビルド コントローラーをチームに 1 つ以上用意する必要があります。

ヒント
チーム プロジェクト コレクションが Team Foundation サービスにホストされている場合は、独自のビルド システムを配置する代わりにホスト ビルド コントローラーを使用できます。

各ビルド コントローラーは、1 つのチーム プロジェクト コレクション専用です。ビルド コントローラーは、ビルド名の決定、バージョン コントロールのラベルの作成、メモの記録、ビルドの状態の報告の作成など、いくつかの軽量のタスクを実行します。ビルド コントローラーは、AgentScope アクティビティを使用して、プロセッサ集中型の処理 (コードのコンパイルやテストの実行など) をプール内のビルド エージェントに委任します。これらのビルド エージェントは、同じビルド サーバーにホストすることも、別のビルド サーバーにホストすることもできます。

通常、ビルド コントローラーはそれほどプロセッサ時間を必要としないため、多くの場合、Team Foundation Server と同じコンピューターにホストできるほか、パフォーマンスの低い物理コンピューターや仮想マシンにホストしてもかまいません。

ただし、状況によっては、ビルド コントローラーは大量のメモリを必要とするので、必要に応じて十分なメモリを確保し、ビルド コントローラーが正常に機能するようにしてください。または、チームのニーズとリソースによっては、Team Foundation Server とは別のコンピューターでビルド コントローラーを実行しなければならない場合もあります。

必要なアクセス許可

ビルド サーバーの Windows Administrators グループのメンバーであり、なおかつチーム プロジェクト コレクションのプロジェクト コレクション ビルド管理者グループのメンバーである必要があります。「Team Foundation Server のアクセス許可」を参照してください。

目的に合ったトピックをクリックしてください

• ビルド コントローラーの作成または変更

• ビルド プロセスで補助的なバイナリを利用できるようにする

• 同時実行ビルドの最大数の指定

• ビルド コントローラーの削除

• Team Foundation サービスにホストされたチーム プロジェクト コレクション内のホスト ビルド コントローラーの使用

Create or modify a build controller

ビルド サーバーからビルド コントローラーを作成または変更するには

1. ビルド サーバーにログオンします。

2. From Windows Start, run Team Foundation Administration Console.

3. In the tree pane of the Team Foundation Administration Console, expand the name of the server, and then choose the Build Configuration node.

   [!メモ]

   "インストール済みフィーチャーの構成" というメッセージが表示された場合は、「ビルド サーバーの配置」を参照してください。

4. [ビルド構成] ページで、目的に応じて操作します。

   • コントローラーが一覧に含まれていない場合は、[新規コントローラー] を選択します。

   • コントローラーが一覧に含まれている場合は、

     

     [プロパティ] を選択します。

   [ビルド コントローラーのプロパティ] ダイアログ ボックスが表示されます。

Visual Studio からビルド コントローラーを変更するには

1. In Visual Studio, in Team Explorer:

   1. If you are not already connected to a team project in the team project collection, then connect to the team project.

   2. [ホーム] を選択し、[ビルド] を選択します。

2. On the Builds page, choose Actions, and then Manage Build Controllers.

   [ビルド コントローラーの管理] ダイアログ ボックスが表示されます。

   

3. 変更するビルド コントローラーを選択し、[プロパティ] を選択します。

   [ビルド コントローラーのプロパティ] ダイアログ ボックスが表示されます。

[表示名] フィールドと [説明] フィールドに、チーム メンバーがビルド プロセスを定義するときに適切なビルド コントローラーを識別しやすいように、わかりやすい名前と説明を入力します。

ビルド コントローラーを構成する方法の詳細については、以下のセクションを参照してください。

Enable your build processes to leverage supplemental binaries

以下のものを利用することで、いっそう細かくビルド プロセスをカスタマイズできます。

• カスタム ワークフロー アクティビティを含むアセンブリ

• カスタム MSBuild タスク

• テストの実行におけるサードパーティの単体テスト フレームワーク。

ビルド処理でこれらの種類のコードを利用できるようにするには、[カスタム アセンブリへのバージョン コントロール パス] ボックスで指定したフォルダー (またはその子孫のフォルダー) にバイナリをチェックインします。このボックスの値を設定または変更すると、ビルド サーバーが自動的に再起動してアセンブリが読み込まれます。

ヒント
ビルド結果に TF215097 エラー メッセージが含まれている場合は、ビルド プロセスに、このフォルダーまたはその子孫のフォルダーにないカスタム アクティビティが含まれている場合があります。

バイナリをバージョン コントロールにチェックインする方法のガイダンスについては、「Leverage third-party binaries that your code does not build (コードでビルドされないサードパーティ バイナリの活用)」を参照してください。

Specify the maximum number of concurrently running builds

通常、この値は [有効なエージェント数を既定値に設定] のままにします。ただし、必要に応じてビルド キューの深さを制御する必要があります。次に例を示します。

• 多数のビルドの状態が "実行中" と表示されていても、実際にはその多くがビルド エージェントの割り当てを待って停止していることがあります。この状態は、チームを混乱させる可能性があります。この問題を避けるには、[最大値を指定] を選択し、ビルド コントローラーにプールされているビルド エージェントの数より小さい値を指定できます。

• ビルド コントローラーにプールされている 12 個のビルド エージェントから複数のビルド エージェントをビルドで同時に利用できるように、カスタム ビルド テンプレートをデザインしてください。このビルド コントローラーによって処理されるビルドは、同時に 3 個のビルド エージェントに委任されるカスタム ビルド テンプレートに基づいています。ビルド キュー データをもっと活用できるように、ビルド コントローラーの構成で [同時実行ビルドの最大数] を [最大値を指定] に設定し、値に 4 を指定できます。

ビルド コントローラーの削除

1. Visual Studio で、「Visual Studio からビルド コントローラーを変更するには」で説明した [ビルド コントローラーの管理] ダイアログ ボックスを開きます。

2. ビルド コントローラーで各ビルド エージェントを選択して削除します。それには、[削除] を選択するか、[プロパティ] を選択し、[ビルド エージェントのプロパティ] ダイアログ ボックスを使用して、ビルド エージェントを別のビルド コントローラーに割り当てます。

3. 削除するビルド コントローラーを選択し、[削除] を選択します。

[!メモ]

ビルド サーバーにログオンしている間に、Team Foundation 管理コンソールを使用してビルド コントローラーを削除することもできます。ただし、その場合は、Visual Studio を使用するか、先に別のビルド サーバーにログオンして、ビルド コントローラーにプールされているリモート ビルド エージェントを削除する必要があります。

Use the Hosted Build Controller in a team project collection hosted on Team Foundation Service

チーム プロジェクト コレクションが Team Foundation サービスにホストされている場合は、独自のビルド コントローラーを配置することなく、ホスト ビルド コントローラーを使用できます。ホスト ビルド コントローラーを使用するには、ビルド処理を定義するときにそれを単に選択します。

ホスト ビルド コントローラーは、標準の一時ビルド エージェントを 1 つ提供します。

ホスト ビルド コントローラーの機能の詳細については、「Use the Hosted Build Controller (ホスト ビルド コントローラーの使用)」を参照してください。

次の手順

• Deploy and configure build agents
  プロセッサ集中型のビルド処理を行うには、ビルド エージェントを使用します。この処理には、バージョン コントロールからのファイルの取得、ワークスペースのプロビジョニング、コードのコンパイル、およびテストの実行が含まれます。ビルド サーバーには 1 つ以上のビルド エージェントをホストできます。

• Set up drop folders
  You can prepare and then designate one or more drop folders so that your build system can deliver binaries, test results, and log files to your team.

• Scale out your Team Foundation Build system
  As your team and your code base grow, you can expand your build system incrementally, with relative ease.

• Manage your build system
  After you deploy your build server, you can manage it from the Team Foundation Administration Console.You can manage the build controller and build agents from either Team Foundation Administration Console or from Visual Studio.

• ビルド処理の定義
  ビルド システムを配置したら、コンパイルするコード プロジェクト、ビルドを発生させるアクション、実行するテスト、チームが必要とする他の手順など、ビルド処理を定義できます。