ビルドエージェントの配置および構成

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

チームで Team Foundation ビルドを使用するには、プロセッサ集中型のビルド処理を行うビルドエージェントが少なくとも 1 つ必要です。

2 台のビルドサーバー

各ビルドエージェントは、1 つのビルドコントローラー専用になり、そのコントローラーによって制御されます。ビルドエージェントは、ビルドコントローラーがホストされているビルドサーバーにホストしてもかまいません。場合によっては、複数のビルドサーバー上のビルドエージェントを制御するビルドコントローラーを単一のビルドサーバーにホストすることで、チームのニーズを最も効率よく満たすことができます。

ビルドエージェントは AgentScope アクティビティに含まれるビルド処理のステップを実行します。通常、このステップには、バージョンコントロールからのファイルの取得、ワークスペースのプロビジョニング、コードのコンパイル、テストの実行、バージョンコントロールへのファイルのマージが含まれます。

ビルドエージェントをホストするビルドサーバーに、チームプロジェクトコレクションのコードベースとテストのサイズや複雑さに対応できるだけの記憶域と処理能力があることを確認してください。通常は、ビルドサーバーのプロセッサコアごとに 1 つのビルドエージェントをホストします。 1 つの物理ハードドライブを各ビルドエージェントの作業ディレクトリ専用にすることでパフォーマンスを高めることもできます。

ヒント

チームプロジェクトコレクションが Visual Studio Online でホストされており、標準のビルドエージェント 1 つでチームのニーズを満たすことができる場合は、独自のビルドエージェントを配置する代わりにホストビルドコントローラーを使用できます。

必要なアクセス許可

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

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

ビルドエージェントの作成または変更
Visual Studio およびその他のソフトウェアをインストールしてコンパイルなどの機能を有効化
作業ディレクトリの指定
ビルドエージェントを有効にしてテストを実行
ビルドエージェントの機能や用途を表すタグの割り当て
Windows ストアアプリをコンパイルおよびテストできるビルドエージェントの配置
ビルドエージェントの削除

ビルドエージェントの作成または変更

ビルドサーバーからビルドエージェントを作成または変更するには

構成するビルドサーバーにログオンします。
Windows の [スタート] メニューから、[Team Foundation 管理コンソール] を実行します。

Team Foundation 管理コンソールが表示されます。
Team Foundation Server 管理コンソールのツリーペインでサーバーの名前を展開し、[ビルド構成] ノードを選択します。

ビルドサーバーに関する情報がコンテンツペインに表示されます。

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

Visual Studio からビルドエージェントを変更するには

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

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

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

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

[表示名]、[説明]: チームメンバーがビルドエージェントを識別しやすいように、わかりやすい名前と説明を入力します。

[コントローラー]: このビルドエージェントを制御するビルドコントローラーを選択します。ビルドコントローラーは、このビルドエージェントと同じビルドサーバー、または別のビルドサーバーで実行できます。

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

Visual Studio およびその他のソフトウェアをインストールしてコンパイルなどの機能を有効化

ビルドエージェントには、チームが開発用コンピューターで使用する Visual Studio のバージョンをインストールする必要があります。「Visual Studio のインストール」を参照してください。また、開発用コンピューターにインストールされていて、アプリのビルドに必要なその他すべてのソフトウェアとコンポーネントもインストールする必要があります。

作業ディレクトリの指定

ビルドエージェントがファイルに対する読み取りと書き込みに使用する作業ディレクトリを指定できます。たとえば、ソースファイルはこのフォルダーのサブディレクトリにコピーされ、作成されたバイナリはこのフォルダーの別のサブディレクトリに格納されます。

ヒント

1 つの物理ハードドライブを各ビルドエージェントの作業ディレクトリ専用にすることでパフォーマンスを高めることができます。

作業ディレクトリトークンの使用

[作業ディレクトリ] プロパティにはリテラルパス (たとえば c:\temp\build\) を指定できますが、トークンを使用してパスを指定する方がさらに簡単で柔軟性のある方法です。 2 種類のトークンを使用できます。

環境変数
環境変数には、システムおよびログオンしているユーザーの環境に関する情報が含まれます。最も一般的に使用される変数は SYSTEMDRIVE ですが、USERNAME や HOMEPATH のような変数が使用される場合もあります。

ヒント

ビルドサーバーで定義されている環境変数の一覧を表示するには、コマンドプロンプトを開き、「set」と入力します。
Team Foundation ビルド変数
ビルドエージェントの作業ディレクトリでは、次の変数を使用できます。
- $(BuildAgentId): チームプロジェクトコレクション内のビルドエージェントを一意に識別する、自動的に生成される整数です。
- $(BuildAgentName): ビルドエージェントの表示名です。
- $(BuildDefinitionId): チームプロジェクトコレクション内のビルド定義を一意に識別する、自動的に生成される整数です。
- $(BuildDefinitionPath): バックスラッシュで区切られたチームプロジェクト名とビルド定義名です。

作業ディレクトリの例

たとえば、BuildBot3 という名前のビルドエージェントがあるものとします。 CoolApp という名前のチームプロジェクトに、NightlyBuild および WeeklyBuild という 2 つのビルドを定義してあります。 [作業ディレクトリ] ボックスで、「$(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath)」という値を指定します。結果として、BuildBot3 ビルドエージェントは次の 2 つの作業ディレクトリを作成して使用します。

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

作業ディレクトリのパスが長すぎないことを確認

指定する作業ディレクトリにより、ビルドエージェントで生成される物理パスが 259 文字を超えないようにする必要があります。 259 文字を超えると、ビルドは失敗し、"TF10128: The path PhysicalPath contains more than the allowed 259 characters. Type or select a shorter path." というエラーがログに記録されます。

この問題を解決するには、物理パスが短くなるように作業ディレクトリを指定してください。たとえば、$(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID) と指定すると、作業ディレクトリは c:\bld\3\2\ のようになります。

作業ディレクトリで作成されるサブディレクトリ

ビルドエージェントは、このパスの下に次のサブディレクトリを作成して使用します。

サブディレクトリ	格納されるファイル
Sources	ソースファイルなど、ビルドエージェントが読み取るファイル。ビルドエージェントがダウンロードするファイルは、各ビルド定義のワークスペース設定で指定します。「ビルドワークスペースの使用」を参照してください。
Binaries	コンパイル済みのアプリケーションファイルなど、ビルドエージェントによってコンパイルされたファイル。
TestResults	ビルドエージェントが実行するすべてのテストで生成されたファイル。

ビルドエージェントを有効にしてテストを実行

1 つまたは複数の自動化されたテスト実行を実行するビルドプロセスを定義できます。

重要

各種のテストやテスト処理を実行するには、チームが開発用コンピューターで使用している Visual Studio のバージョンがビルドエージェントにインストールされている必要があります。「Visual Studio のインストール」を参照してください。

ビルドエージェントでは以下を実行できます。

コードカバレッジ
コード化された UI テスト (対話モードで実行されているビルドサーバーが必要です。「対話モードでのビルドサーバーの実行」と「UI オートメーションを使用したコードの検証」を参照してください)
データベーステストデータの生成
データベース単体テスト
汎用テスト
ロードテスト
単体テスト
順序指定テスト
テスト影響分析
Web テスト

ビルドエージェントの機能や用途を表すタグの割り当て

ビルドシステムの規模が大きくなると、特別なビルドエージェントの定義が必要になる場合があります。ビルドエージェントに特別な機能がある場合、または特定の用途がある場合は常に、1 つまたは複数のタグをそのエージェントに割り当てる必要があります。このようにすることで、チームメンバーが特定の種類のビルドエージェントを必要とするビルド定義を作成するときは、ビルド定義でタグを指定できます。

タグは、既に説明した [ビルドエージェントのプロパティ] ダイアログボックスで割り当てることができます。その後で、ビルド定義にタグを適用できます。

次の表では、タグ名とそれが表すビルドエージェントの機能の例を示します。

適用できるタグ	ビルドエージェントの機能
x86	32 ビットアプリケーションをコンパイルします。
x64	64 ビットアプリケーションをコンパイルします。
bvt	夜間 BVT ビルドで実行される BVT テストを実行します。
WindowsStore	Windows ストアアプリをコンパイルしてテストします。
IIS	ASP.NET Web アプリケーションをコンパイルした後、ビルドエージェントが実行されているコンピューターにステージングしてホストします。
interactive	対話モードで実行されているビルドサーバーでエージェントが必要なタスクを実行します。

1 つのビルドエージェントに、複数のタグを割り当てることができます。たとえば、x86 および Release というタグを割り当てたビルドエージェントを作成することで、32 ビットアプリケーションのリリース構成をコンパイルするように設定されたエージェントを示すことができます。

同じビルドサーバーで複数のビルドエージェントを実行する場合、通常はすべてのビルドエージェントが同じ機能を持つと考えられます。したがって、通常は、そのビルドサーバーのすべてのビルドエージェントに同じタグを適用します。

ビルドエージェントの削除

Visual Studio で、「ビルドエージェントの作成または変更」で説明した [ビルドコントローラーの管理] ダイアログボックスを開きます。
削除するビルドエージェントを選択し、[削除] を選択します。

ヒント

ビルドサーバーにログオンしている間に、Team Foundation 管理コンソールを使用してビルドエージェントを削除することもできます。

次の手順

Team Foundation ビルドシステムのスケールアウト
チームとコードベースの拡大に合わせて、比較的簡単にビルドシステムをインクリメント方式で拡張できます。
ビルドシステムの管理
ビルドシステムの監視と管理が必要になることがあります。
ビルドシステムを使用したアプリのコンパイル、テスト、および配置
ビルドシステムの準備ができたら、チームで単純なビルド処理を作成し (たとえば、継続的インテグレーションビルド)、アプリのビルドとテストを自動化できます。

ビルド エージェントの配置および構成

ビルド エージェントの作成または変更

ビルド サーバーからビルド エージェントを作成または変更するには

Visual Studio からビルド エージェントを変更するには