方法 : ビルド定義を作成する
更新 : 2007 年 11 月
Team Foundation ビルドは、ビルド定義を使用して、チーム プロジェクト内の単一のソリューションまたはソリューションのセットをビルドするときの条件を設定します。ビルドを実行するには、新しいビルド定義を作成するか、または既存のビルド定義を使用する必要があります。
[ビルド定義] ダイアログ ボックスを使用してビルド定義を作成するとき、いくつかのオプションを設定できます。これらのオプションには、ビルド名、ビルドするファイルに使用するソース管理ワークスペース、TFSBuild.proj プロジェクト ファイルの場所、ビルド エージェント、ビルドの保持ポリシー、ビルド トリガなどが含まれます。既存の MSBuild プロジェクト ファイルがない場合は、[ビルド定義] ダイアログ ボックスを使用して MSBuild プロジェクト ファイルの作成ウィザードを起動し、ビルド定義に使用する新しい TFSBuild.proj ファイルを作成できます。[ビルド エージェントのプロパティ] ダイアログ ボックスを開いて、新しいビルド エージェントを作成することもできます。
新しいビルド定義を作成したら、これらのオプションを変更できます。詳細については、「方法 : ビルド定義を編集する」を参照してください。
MSBuild 形式で記述されている TFSBuild.proj プロジェクト ファイルを編集することで、ビルド定義をさらにカスタマイズできます。詳細については、「Team Foundation ビルドのカスタマイズ」を参照してください。
ビルド定義は、まず、ビルド定義に関連付けられているビルドを削除することによって削除されます。次に、ビルド定義自体を削除することもできます。詳細については、「方法 : ビルド定義を削除する」を参照してください。
必要なアクセス許可
この手順を実行するには、[ビルドを管理します] のアクセス許可が [許可] に設定されている必要があります。さらに、アプリケーション層サービス アカウントおよび Team Foundation ビルド サービス アカウントが、ビルドの格納場所に対する読み取り/書き込みアクセス許可を持っている必要があります。詳細については、「Team Foundation Server のアクセス許可」を参照してください。
新しいビルド定義を作成するには
チーム エクスプローラで、新しいビルド定義を作成するプロジェクトを選択します。
[ビルド] メニューの [ビルド定義の新規作成] をクリックします。
[ビルド定義] ダイアログ ボックスが開き、[全般] が選択された状態で表示されます。
.gif "ヒント")
ヒント :警告アイコンが横に示されているタブは、入力必須です。
[ビルド定義名] ボックスに、ビルド定義に関連付ける名前を指定します。
重複しない有効な Windows ファイル名を入力する必要があります。
[説明] ボックスに、適切な説明を追加します。
ここで入力した説明は、[ビルド "<チーム プロジェクト名>" をキューに配置] ダイアログ ボックスに表示されます。詳細については、「方法 : ビルド定義をキューに配置する/ビルド定義を開始する」を参照してください。
[ワークスペース] タブをクリックします。
[作業フォルダ] テーブルには、既定で、新しいビルド定義を作成しているチーム プロジェクト用のソース管理フォルダと、ビルド エージェント上のローカル フォルダが含まれます。ビルド エージェント上のローカル フォルダは、[ローカル フォルダ] 列に表示されます。ビルド エージェント上のすべてのワークスペース パスは、表示されている既定のルート ディレクトリに対してマップされます。
既存のワークスペースを作業フォルダの一覧にコピーするには、[既存のワークスペースのコピー] をクリックし、[コピーするワークスペースを選択] ダイアログ ボックスを開きます。
選択したワークスペースは、ビルド エージェントで共通のルート ディレクトリの子になります。
[ソース管理フォルダ] で空のテーブル セルをクリックし、省略記号 (…) をクリックしてソース管理フォルダを参照し、作業フォルダを追加することもできます。選択したソース管理フォルダは、ビルド エージェントでの共通のルート ディレクトリに対して正規化されます。
[プロジェクト ファイル] タブをクリックします。[プロジェクト ファイル] ペインでは、既存の TFSBuild.proj プロジェクト ファイルを参照することもできますし、MSBuild プロジェクト ファイルの作成ウィザードを起動して新しい TFSBuild.proj ファイルを作成することもできます。
既存の TFSBuild.proj ファイルを参照するには、[参照] をクリックします。[フォルダの参照] ダイアログ ボックスで、TeamBuildTypes フォルダから既存のビルド定義を選択し、[OK] をクリックします。
これで、既存のビルド定義と新しいビルド定義の間で TFSBuild.proj ファイルは共有されるようになりました。
TFSBuild.proj ファイルが検出されると、[プロジェクト ファイル] ペインに "見つかった MSBuild プロジェクト ファイル: TFSBuild.proj" というテキストが表示されます。プロジェクト ファイルが見つからない場合は、[プロジェクト ファイル] ペインに警告テキストが表示され、新しい MSBuild プロジェクト ファイルを作成するように指示されます。
.gif "重要 :")
重要 :共有された TFSBuild.proj ファイルに変更を加えると、そのファイルが関連付けられているすべてのビルド定義をカスタマイズすることになります。詳細については、「Team Foundation ビルドのカスタマイズ」を参照してください。
ビルド定義に新しいプロジェクト ファイルを作成するには、[作成] をクリックします。MSBuild プロジェクト ファイルの作成ウィザードが表示されます。
[ビルドするソリューションの選択および順番指定] ページで、ビルドするソリューションを選択します。ソリューションの順序を変更するには、ソリューションを 1 つ選択し、一覧の右側にある方向キーを使用して、ビルド順序内のソリューションの位置を変更します。
注意 :ソリューションのビルド順序を決定するときは、他のソリューションと依存関係にあるソリューションに注意してください。たとえば、Solution2 が Solution1 に依存している場合は、Solution1 を Solution2 より先にビルドする必要があります。
[次へ] をクリックします。
[ビルドする構成の選択] ページが表示されます。
[ビルドするための構成を選択してください] の下のグリッドで、ビルド定義に含める構成とプラットフォームを選択します。ビルド構成は、構成とプラットフォームを示します (例 : Release と Any CPU)。
メモ :Web プロジェクトのビルド定義を作成している場合は、[プラットフォーム] メニューの [混合プラットフォーム] を選択します。
[次へ] をクリックします。
[ビルド オプションの選択] ページが表示されます。
必要に応じて [テストの実行 (BVT の実行など)] チェック ボックスと [コード分析の実行] チェック ボックスをオンにして、目的のビルド オプションを指定します。[テストの実行 (BVT の実行など)] チェック ボックスをオンにする場合は、ドロップダウン オプションを使用して [テスト用のメタデータ ファイル] と [実行するテスト リスト] を適宜指定します。
詳細については、「テスト リストの使用」および「高品質なコードの作成」を参照してください。
重要 :テストを実行するためには、ビルド エージェントに Team Edition for Testers がインストールされている必要があります。コード分析を実行するためには、ビルド エージェントに Team Edition for Developers がインストールされている必要があります。
[完了] をクリックします。
[ビルド定義] ダイアログ ボックスの [プロジェクト ファイル] ペインが表示されます。作成した TFSBuild.proj ファイルは、ソース管理の $<Team Project>\TeamBuild Types\<Build Definition Name>\TFSBuild.proj に格納されます。
[アイテム保持ポリシー] タブをクリックします。[ビルドの保持方法を指定] の一覧では、失敗、停止、部分的に成功、または完全に成功というビルド結果に対して保持ポリシーを選択できます。ドロップダウン リストから保持ポリシーを選択します。[<保持する数を指定>] を選択すると、[ビルド数] ダイアログ ボックスが表示されます。[保持するビルド数を指定] ボックスに、指定したビルドの結果について保持するビルドの数を入力します。
[ビルドの既定値] タブをクリックします。[ビルドの既定値] ペインでは、[ビルド エージェント] ボックスの一覧から既存のビルド エージェントを選択できます。ビルド エージェントが存在しない場合や、新しいビルド エージェントを作成する場合は、[新規作成] をクリックします。[ビルド エージェントのプロパティ] ダイアログ ボックスが表示されます。[表示名]、[説明]、[コンピュータ名] の各ボックスに入力し、[OK] をクリックします。詳細については、「方法 : ビルド エージェントを作成および管理する」を参照してください。
[ビルドのステージング先の共有場所 (例: \\server\share)] ボックスに、UNC (\\server\share) の場所を入力します。ビルドの完了直後に、ビルド バイナリとログ ファイルがこのフォルダに配置されます。
メモ :この手順を完了する前に、TFSService アカウントがフル アクセス権を持つビルド エージェント コンピュータ上にパブリック フォルダを作成しておく必要があります。Team Foundation サービス アカウントの詳細については、「方法 : Team Foundation Server サービスを表示する」を参照してください。
[トリガ] タブをクリックします。
[トリガ] ペインで、[チェックインにより新しいビルドをトリガしない] を選択し、オン デマンドでのみビルドするようにします。
[チェックインのたびにビルドする (ビルド数多)] を選択すると、ビルド定義でビルドされているファイルに変更がチェックインされるたびに、継続的なビルドが行われます。
[前のビルドの完了までチェックインを蓄積する (ビルド数少)] を選択すると、ロール ビルドが作成されます。[前のビルドの完了までチェックインを蓄積する (ビルド数少)] チェック ボックスがオンの場合、[最小ビルド間隔] チェック ボックスをオンにし、[分毎] ボックスに数値を入力することで、ビルドの発生頻度を指定できます。
[分毎] ボックスに入力できる有効な範囲は、0 ～ 2147483647 (Int32 MaxValue) です。
メモ :Service Pack 1 が適用されている Visual Studio Team System 2008 Team Foundation Server を使用している場合、ロール ビルドの間隔を 120 ～ 240 分に設定できます。Service Pack 1 が適用されていない Visual Studio Team System 2008 Team Foundation Server を使用している場合、Team Foundation ビルドではその範囲内の値は無視されます。
スケジュールされたビルドを作成するには、[毎週以下の曜日にビルドする] を選択し、曜日ごとに用意されているチェック ボックスを使用して、ビルドを実行する曜日を選択します。[既定のビルド エージェント上でビルドをキューに配置する時刻] ボックスには、ビルドを実行する時刻を入力します。
メモ :前回のビルド以降、変更がチェックインされない限り、スケジュールされたビルドは行われません。
必要なすべての情報を入力したら、[OK] をクリックし、ビルド定義を作成します。
作成されたビルド定義は、チーム エクスプローラの [ビルド] フォルダに表示されます。サーバー上に格納されているビルド定義の情報を確認するには、チーム エクスプローラ内で右クリックし、[ビルド定義の編集] をクリックします。[ビルド定義] ダイアログ ボックスが開き、入力した情報が表示されます。入力した情報を変更することもできます。詳細については、「方法 : ビルド定義を編集する」を参照してください。
重要 :別のビルドと TFSBuild.proj ファイルを共有しているビルド定義の場合、そのビルド定義と関連ファイルはソース管理エクスプローラの TeamBuildTypes フォルダには表示されません。ここには、元のビルド定義だけが一覧表示されます。
参照
処理手順
チュートリアル : Team Foundation ビルドでのビルド定義の作成
方法 : Team Foundation ビルド エージェントのアクセス許可を確立する
方法 : Team Foundation ビルドをセットアップおよびインストールする
チュートリアル : カスタム タスクを使って Team Foundation ビルドをカスタマイズする