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

[アーティクル]
06/09/2015

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

単一コンピューターシステム (スタンドアロン)

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

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

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

2 台のビルドサーバー

必要なアクセス許可

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

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

ビルドコントローラーの作成または変更
ビルドプロセスで補助的なバイナリを利用できるようにする
同時実行ビルドの最大数の指定
ビルドコントローラーの削除
Visual Studio Online でホストされたチームプロジェクトコレクションでのビルドコントローラーの使用

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

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

ビルドサーバーにログオンします。
Windows の [スタート] メニューから、[Team Foundation 管理コンソール] を実行します。
Team Foundation Server 管理コンソールのツリーペインでサーバーの名前を展開し、[ビルド構成] ノードを選択します。

注意

"インストール済みフィーチャーの構成" というメッセージが表示された場合は、「ビルドサーバーの配置」を参照してください。
[ビルド構成] ページで、目的に応じて操作します。
- コントローラーが一覧に含まれていない場合は、[新規コントローラー] を選択します。
- コントローラーが一覧に含まれている場合は、
  
  [プロパティ] を選択します。
[ビルドコントローラーのプロパティ] ダイアログボックスが表示されます。

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

Visual Studio のチームエクスプローラーで次の操作を行います。
1. チームプロジェクトコレクション内のチームプロジェクトにまだ接続されていない場合は、チームプロジェクトに接続します。
2. [ホーム] を選択し、 [ビルド] を選択します。
[ビルド] ページで [アクション] を選択し、[ビルドコントローラーの管理] を選択します。

[ビルドコントローラーの管理] ダイアログボックスが表示されます。
変更するビルドコントローラーを選択し、[プロパティ] を選択します。

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

[ビルドコントローラーのプロパティ] ダイアログボックス

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

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

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

Team Foundation Server にアップロードしたバイナリをビルド処理で利用できるようにすることができます。たとえば、次のようなバイナリです。

カスタムワークフローアクティビティを含むアセンブリ。「カスタムビルドプロセスのアクティビティを使用と開発を行う」を参照してください。
サードパーティ製の単体テストフレームワーク。「ビルドプロセスでのテストの実行」を参照してください。
カスタム MSBuild タスク

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

ヒント

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

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

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

多数のビルドの状態が "実行中" と表示されていても、実際にはその多くがビルドエージェントの割り当てを待って停止していることがあります。この状態は、チームを混乱させる可能性があります。この問題を避けるには、[最大値を指定] を選択し、ビルドコントローラーにプールされているビルドエージェントの数より小さい値を指定できます。
ビルドコントローラーにプールされている 12 個のビルドエージェントから複数のビルドエージェントをビルドで同時に利用できるように、カスタムビルドテンプレートをデザインしてください。このビルドコントローラーによって処理されるビルドは、同時に 3 個のビルドエージェントに委任されるカスタムビルドテンプレートに基づいています。ビルドキューデータをもっと活用できるように、ビルドコントローラーの構成で [同時実行ビルドの最大数] を [最大値を指定] に設定し、値に 4 を指定できます。

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

Visual Studio で、「Visual Studio からビルドコントローラーを変更するには」で説明した [ビルドコントローラーの管理] ダイアログボックスを開きます。
ビルドコントローラーで各ビルドエージェントを選択して削除します。それには、[削除] を選択するか、[プロパティ] を選択し、[ビルドエージェントのプロパティ] ダイアログボックスを使用して、ビルドエージェントを別のビルドコントローラーに割り当てます。
削除するビルドコントローラーを選択し、[削除] を選択します。

注意

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

Visual Studio Online でホストされたチームプロジェクトコレクションでのビルドコントローラーの使用

ホストビルドコントローラーの使用: チームプロジェクトコレクションが Visual Studio Online でホストされている場合は、独自のビルドコントローラーを配置せずに、ホストビルドコントローラーを使用できます。 ホストビルドコントローラーを使用するには、ビルド処理を定義するときにそれを単に選択します。「Use the Hosted Build Controller (ホストビルドコントローラーの使用)」を参照してください。

内部設置型のビルドコントローラーの使用: ビルドプロセスでホストビルドコントローラーの機能以外のリソースが必要である場合、ホストされているチームプロジェクトコレクションに内部設置型のビルドコントローラーを接続できます。

Team Foundation Service、内部設置型ビルドサーバー

次の手順

ビルドエージェントの配置と構成
プロセッサ集中型のビルド処理を行うには、ビルドエージェントを使用します。この処理には、バージョンコントロールからのファイルの取得、ワークスペースのプロビジョニング、コードのコンパイル、およびテストの実行が含まれます。ビルドサーバーには 1 つ以上のビルドエージェントをホストできます。
ドロップフォルダーのセットアップ
ビルドシステムがバイナリ、テスト結果、およびログファイルをチームに配信できるように、ドロップフォルダーを 1 つ以上準備して指定できます。
Team Foundation ビルドシステムのスケールアウト
チームとコードベースの拡大に合わせて、比較的簡単にビルドシステムをインクリメント方式で拡張できます。
ビルドシステムの管理
ビルドサーバーを配置した後、Team Foundation 管理コンソールからそれを管理できます。ビルドコントローラーとビルドエージェントは Team Foundation 管理コンソールまたは Visual Studio から管理できます。
ビルド処理の定義
ビルドシステムを配置したら、コンパイルするコードプロジェクト、ビルドを発生させるアクション、実行するテスト、チームが必要とする他の手順など、ビルド処理を定義できます。

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

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

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

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

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