ビルド コントローラーの配置および構成
Team Foundation ビルドを使用するには、軽量タスクを実行し、プロセッサ負荷の高いビルド処理をビルド エージェントのプールに分散させるためのビルド コントローラーをチームに 1 つ以上用意する必要があります。
各ビルド コントローラーは、1 つのチーム プロジェクト コレクション専用です。 ビルド コントローラーは、ビルド名の決定、バージョン コントロールのラベルの作成、メモの記録、ビルドの状態の報告の作成など、いくつかの軽量のタスクを実行します。 ビルド コントローラーは、AgentScope アクティビティを使用して、プロセッサ集中型の処理 (コードのコンパイルやテストの実行など) をプール内のビルド エージェントに委任します。 これらのビルド エージェントは、同じビルド サーバーにホストすることも、別のビルド サーバーにホストすることもできます。
通常、ビルド コントローラーはそれほどプロセッサ時間を必要としないため、多くの場合、Team Foundation Server と同じコンピューターにホストできるほか、パフォーマンスの低い物理コンピューターや仮想マシンにホストしてもかまいません。
ただし、状況によっては、ビルド コントローラーは大量のメモリを必要とするので、必要に応じて十分なメモリを確保し、ビルド コントローラーが正常に機能するようにしてください。 または、チームのニーズとリソースによっては、Team Foundation Server とは別のコンピューターでビルド コントローラーを実行しなければならない場合もあります。
必要なアクセス許可
ビルド サーバーの Windows Administrators グループのメンバーであり、なおかつチーム プロジェクト コレクションのプロジェクト コレクション ビルド管理者グループのメンバーである必要があります。 「Team Foundation Server のアクセス許可の参照」を参照してください。
目的に合ったトピックをクリックしてください
ビルド コントローラーの作成または変更
ビルド プロセスで補助的なバイナリを利用できるようにする
同時実行ビルドの最大数の指定
ビルド コントローラーの削除
Visual Studio Online でホストされたチーム プロジェクト コレクションでのビルド コントローラーの使用
ビルド コントローラーの作成または変更
ビルド サーバーからビルド コントローラーを作成または変更するには
ビルド サーバーにログオンします。
Windows の [スタート] メニューから、[Team Foundation 管理コンソール] を実行します。
Team Foundation Server 管理コンソールのツリー ペインでサーバーの名前を展開し、[ビルド構成] ノードを選択します。
注意
"
インストール済みフィーチャーの構成" というメッセージが表示された場合は、「ビルド サーバーの配置」を参照してください。
[ビルド構成] ページで、目的に応じて操作します。
コントローラーが一覧に含まれていない場合は、[新規コントローラー] を選択します。
コントローラーが一覧に含まれている場合は、
[プロパティ] を選択します。
[ビルド コントローラーのプロパティ] ダイアログ ボックスが表示されます。
Visual Studio からビルド コントローラーを変更するには
Visual Studio のチーム エクスプローラーで次の操作を行います。
チーム プロジェクト コレクション内のチーム プロジェクトにまだ接続されていない場合は、チーム プロジェクトに接続します。
[ホーム] を選択し、
[ビルド] を選択します。
[ビルド] ページで [アクション] を選択し、[ビルド コントローラーの管理] を選択します。
[ビルド コントローラーの管理] ダイアログ ボックスが表示されます。
変更するビルド コントローラーを選択し、[プロパティ] を選択します。
[ビルド コントローラーのプロパティ] ダイアログ ボックスが表示されます。
[表示名] フィールドと [説明] フィールドに、チーム メンバーがビルド プロセスを定義するときに適切なビルド コントローラーを識別しやすいように、わかりやすい名前と説明を入力します。
ビルド コントローラーを構成する方法の詳細については、以下のセクションを参照してください。
ビルド プロセスで補助的なバイナリを利用できるようにする
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 (ホスト ビルド コントローラーの使用)」を参照してください。
内部設置型のビルド コントローラーの使用: ビルド プロセスでホスト ビルド コントローラーの機能以外のリソースが必要である場合、ホストされているチーム プロジェクト コレクションに内部設置型のビルド コントローラーを接続できます。
次の手順
ビルド エージェントの配置と構成
プロセッサ集中型のビルド処理を行うには、ビルド エージェントを使用します。 この処理には、バージョン コントロールからのファイルの取得、ワークスペースのプロビジョニング、コードのコンパイル、およびテストの実行が含まれます。 ビルド サーバーには 1 つ以上のビルド エージェントをホストできます。ドロップ フォルダーのセットアップ
ビルド システムがバイナリ、テスト結果、およびログ ファイルをチームに配信できるように、ドロップ フォルダーを 1 つ以上準備して指定できます。Team Foundation ビルド システムのスケール アウト
チームとコード ベースの拡大に合わせて、比較的簡単にビルド システムをインクリメント方式で拡張できます。ビルド システムの管理
ビルド サーバーを配置した後、Team Foundation 管理コンソールからそれを管理できます。 ビルド コントローラーとビルド エージェントは Team Foundation 管理コンソールまたは Visual Studio から管理できます。ビルド処理の定義
ビルド システムを配置したら、コンパイルするコード プロジェクト、ビルドを発生させるアクション、実行するテスト、チームが必要とする他の手順など、ビルド処理を定義できます。