ビルドの問題の診断
ビルドの問題を診断して修正ソフトウェア開発の定期的なタスクです。Team Foundation ビルドはなどの問題を診断し、解決するためのツールが用意されています:
失敗したか部分的な成功したビルド
例外は、エラー、警告
予期しない結果またはイベント
目的に合ったトピックをクリックしてください
ビルドがなぜ実行されていないかを確認します
ビルド結果ウィンドウの問題に関する情報を検索します
診断ログを要求し、表示します。
内部インストール型のビルド コントローラーを使用しているときに診断ログを取得します。
ホストのビルド コントローラーを使用しているときに診断ログを取得します。
診断ログを表示します。
ビルド システムをチェックし、ビルド プロセスのデバッグ
詳細なヒントを取得します。
必要なアクセス許可
ビルド サーバーで Windows の Administrators グループのメンバー、およびチーム プロジェクト コレクションのプロジェクト コレクション ビルド管理者グループのメンバーである必要があります。「Team Foundation Server のアクセス許可」を参照してください。
ビルドがなぜ実行されていないかを確認します
ビルドが次の キュー ですが、まだ実行されていない場合は、ビルド コントローラーとビルド エージェントの少なくとも 1 つが使用できる、有効になっていることを確認します。ビルド処理はビルド エージェントのフィルターがある場合は、使用できる、有効になった条件を満たすビルド エージェントことを確認します。Manage Your Build System、ビルド エージェントは、ビルドを処理するかを指定します。、ビルド エージェントの配置および構成"を参照してください。
ビルド結果ウィンドウの問題に関する情報を検索します
ビルドがの場合、プロセスの一部で、または終了と実行 [build results window]の問題に関する詳細情報を取得できます。数値。詳細情報を表示するには [ログの表示] を選択する:
ビルドの問題に直接スキップするには [次のエラー] か [次の警告] を選択します。
表示する場所で [MSBuild ログ ファイル] のインスタンスは [MSBuild] のアクティビティが、コードをコンパイルし、他のタスクを実行したときにイベントの詳細情報を得るにはリンク、をクリックします。
情報ができ、問題の解決に役立つことができるユーザーをコピーすると、それを共有します。ログの SELECT 特定の変更は、そのログからショートカット メニューを開き、[すべて選択] を選択します。ショートカット メニューを開き、クリップボードにテキストをコピーするには [コピー] を選択できます。
診断ログの表示
も問題を診断するのに十分な情報がより詳細な診断ログを表示できます。
.gif "JJ635150.collapse_all(ja-jp,VS.110).gif")
内部インストール型のビルド コントローラーを使用しているときに診断ログを取得します。
内部インストール型のビルド コントローラーをホストする場合は、診断ログは ドロップ フォルダーに格納されます。次に [build results window]では、[診断] を選択する場合:
ビルドが完了 現在の最終的なログ 、日時を選択します。
ビルドが完了し、を選択すると [ログの要求] を指定します。
.png "診断ログの取得")
システムは、ログを構築します。
ログの準備が整うと、[診断]、現在 日時 には ログを要求したユーザーを選択します。
システムは診断ログを含む格納フォルダーのサブフォルダーを開きます。
[!メモ]
Visual Studio 2010 を使用して、[診断] のメニューは、ビルド結果ウィンドウに表示されませんが、ビルドが完了したときにまだログオンしてドロップ フォルダーを診断を表示できます。
ホストのビルド コントローラーを使用しているときに診断ログを取得します。
使用 [ホスト ビルド コントローラー]するときは、[staging location]の [ビルド出力をサーバーにコピーする] を選択することをお勧めします。この場合、診断ログは、TFS に格納され、それらを表示し、Web ブラウザーからダウンロードできます。
次に [build results window]では、[アクション]、Web ブラウザーのビルド結果の [ブラウザーで開く] を選択します [診断] を選択します。次に、表示するまたはすべてのダウンロードするには .zip ファイルを使用してログを選択できるメニューを開くに [ログの表示] を選択できます。
診断ログを表示します。
ドロップ フォルダーを開くか、.zip ファイルをダウンロードすると、次の 1 種類のログを表示する:
ビルド コントローラーから: ActivityLog
ビルドに参加した各ビルド エージェントから: **ActivityLog.AgentScope.**Build_Agent_ID
[MSBuild] のアクティビティでコンパイルされた各ソリューションの場合: Solution_Name
これらのログを表示する最善の方法は、を使用して dev のコンピューターにコピーして、そこに開くことです。
ビルド システムをチェックし、ビルド プロセスのデバッグ
問題は、インストールの内部型のビルド システムで発生する可能性があります。
.gif "ヒント") ヒント |
|---|
より簡単にビルド処理が実行される環境への直接アクセスを取得できるようにビルド サーバーとして、dev のコンピューターを展開してください。「ビルド サーバーの配置および構成」を参照してください。 |
ビルド システム コンポーネントをチェックします。
ビルド サーバー、コントローラーとエージェントが正しく構成されていることを確認します。ビルド サーバーの配置および構成、ビルド コントローラーの配置および構成、および ビルド エージェントの配置および構成 を参照してください。
ビルド サーバーにログオンし、それが正常に動作していることを確認します。また、ビルド サーバーの詳細な診断データを表示できます。「Manage Your Build System」を参照してください。
ビルド サーバーでビルド プロセスのデバッグ
カスタム ビルド処理 のアクティビティ、または状態で例外にある問題を診断することで、ビルド サーバー上でビルドのプロセスをデバッグします。
ビルド サーバーにログオンします。
管理者として実行の Visual Studio。
Visual Studio で、メニュー バーで、[ツール]、[プロセスにアタッチ] を選択します。
ダイアログ ボックスの [プロセスにアタッチ] :
[すべてのユーザーからのプロセスを表示する] を選択します。
[TFSBuildServiceHost.exe] を選択します。
[アタッチ] を選択します。
メニュー バーの [デバッグ]、[例外] を選択します。[例外] のダイアログ ボックス、選択 [Common Language Runtime Exceptions]。[OK] をクリックします。
メニュー バーで、[ツール]、[オプション] を選択します。[オプション] のダイアログ ボックス、ツリー ペインで、を選択します [デバッグ]。[全般] の一覧で、[マイ コードのみを有効にする] のチェック ボックスをオフにします。[OK] をクリックします。
Visual Studio で、ビルドをキューに配置します。 は、デバッガーを有効にしたビルド サーバーでホストされるビルド サーバーおよびビルド コントローラーで実行されることを確認します。
ビルド処理中に、スローされる例外をデバッグし、ブレークポイントを設定し、カスタム ビルド プロセスのアクティビティをデバッグします。「Visual Studio でのデバッグ」を参照してください。
ヒント
.png "ヒント")
ビルド処理に関する問題を診断しながら、一時停止して、自分やチームの一員問題を保存する場合があります。プロセスを修正できるまで:次に [全般] のタブの下部のビルド定義を編集します。は、[一時停止中] を選択します。
ビルド定義が一時停止中、ビルドのプロセスの修正をテストするには、キューに入っているビルドを選択し、ショートカット メニューを開き、を [今すぐ開始] を選択します。
- 考えて、ビルド システム コンポーネントの 1 つが起動、停止、またはビルド サーバーを再起動するか、必要に応じてコントローラーとエージェントを有効または無効にできます。の 1、問題の原因である場合があります。「Manage Your Build System」を参照してください。
- 多くの場合、問題解決、ビルド処理中にさまざまな修正をテストするために同じオプションのビルドに繰り返しキューに置く必要があります。ビルド速度を再試行できます:
[アクション] のオプションによって [build results window] から、[ビルドの再試行]。
からチーム エクスプローラーの [Builds page] または完了したビルドを選択し、ショートカット メニューを開き、を [ビルドの再試行] を選択することによってビルド エクスプローラー。