Build-Problemdiagnose

Artikel
02/26/2013

Buildprobleme zu bestimmen und die Behebung ist eine reguläre Aufgabe in der Softwareentwicklung.Team Foundation Build enthält Tools, die Ihnen helfen, Probleme wie zu ermitteln und zu beheben:

Fehlgeschlagene oder teilweise erfolgreiche Builds
Ausnahmen, Fehler oder Warnungen
Unerwartete Ereignisse oder Ergebnisse

Was möchten Sie tun?

Bestimmen Sie, warum ein Build nicht ausgeführt wird
Suchen Sie nach Informationen über ein Problem im Fenster Buildergebnisse
Lösen Sie Probleme auf, wenn Sie den gehosteten Buildcontroller verwenden
Fordern Sie und zeigen Sie um Diagnoseprotokolle an
- Rufen Sie Diagnoseprotokolle ab, wenn Sie einen lokalen Buildcontroller verwenden
- Rufen Sie Diagnoseprotokolle ab, wenn Sie den gehosteten Buildcontroller verwenden
- Zeigen Sie die Diagnoseprotokolle an
Überprüfen Sie das Buildsystem und debuggen Sie den Buildprozess
Rufen Sie mehr Tips ab

Erforderliche Berechtigungen

Sie müssen Mitglied der Windows-Administrator-Gruppe auf dem Buildserver und Mitglied der Projektsammlungs-Build-GruppeAdministratoren auf der Teamprojektsammlung sein.Siehe Team Foundation Server-Berechtigungen.

Bestimmen Sie, warum ein Build nicht ausgeführt wird

Wenn der Build ist, wenn in der Warteschlange jedoch noch nicht ausgeführt wird, stellen Sie sicher, dass der Buildcontroller und mindestens einer der Build-Agent verfügbar und aktiviert sind.Wenn der Buildvorgang Build-Agent-Filter verfügt, vergewissern Sie sich, dass ein Build-Agent, der die Kriterien erfüllt, verfügbar ist und aktiviert.Siehe Manage Your Build System, Geben Sie an, welche Build-Agents der Build verarbeitet und Bereitstellen und Konfigurieren eines Build-Agents.

Suchen Sie nach Informationen über ein Problem im Fenster Buildergebnisse

Wenn der Build ausgeführt wird, In an Teilen des Prozesses oder abgeschlossen, dann können Sie weitere Informationen zu Problemen in Fenster abrufen.Wählen Sie Protokoll anzeigen, um ausführlichere Informationen anzuzeigen:

Wählen Sie Nächster Fehler oder Nächste Warnung, direkt zu den Problemen im Build zu überspringen.
Wenn Sie finden, verknüpfen Instanzen von MSBuild-Protokolldatei, wählen es, um ausführlichere Informationen über Ereignisse abzurufen, die aufgetreten sind, als die MSBuild-Aktivität den Code kompilierte und andere Aufgaben ausführen.
Sie können Informationen kopieren und, wenn Sie möchten, geben sie mit Personen freigegeben, die Ihnen helfen können, die Probleme zu beheben.Wählen Sie bestimmte Durchgänge im Protokoll aus oder öffnen Sie ein Kontextmenü überall im Protokoll und wählen Sie dann Alle auswählen aus.Sie können ein Kontextmenü öffnen und Kopieren auswählen, um den Text in die Zwischenablage zu kopieren.

Diagnoseprotokolle der Ansicht

Wenn Sie noch nicht über genügend Informationen verfügen, das Problem zu bestimmen, können Sie ausführlichere Diagnoseprotokolle anzeigen.

Rufen Sie Diagnoseprotokolle ab, wenn Sie einen lokalen Buildcontroller verwenden

Wenn Sie einen lokalen Buildcontroller hosten, werden die Diagnoseprotokolle in Ablageordner gespeichert.In FensterDiagnose wählen Sie und dann aus:

Wenn der Build abgeschlossen wird, wählen Sie Schlussprotokolle ab Datum und Uhrzeit aus.
Wenn der Build noch nicht abgeschlossen ist, wählen Sie Anforderungsprotokolle aus.

Das System wird die Protokolle zusammen.

Wenn die Protokolle bereit sind, wählen Sie Diagnose, Ab Datum und Uhrzeit für Benutzer, der das Protokoll angeforderten aus.

Das System öffnet einen Ablageordnerunterordner, der die Diagnoseprotokolle enthält.

Hinweis
Wenn Sie Visual Studio 2010 verwenden, wird das Menü Diagnose nicht im Fenster Buildergebnisse angezeigt, können die Diagnose noch anzeigen anmelden den Ablageordner, wenn der Build abgeschlossen wird.

Rufen Sie Diagnoseprotokolle ab, wenn Sie den gehosteten Buildcontroller verwenden

Wenn Sie verwenden Gehosteter Buildcontroller, wird empfohlen, Buildausgabe auf den Server kopieren für Stagingspeicherort auswählen.In diesem Fall werden die Diagnoseprotokolle in TFS gespeichert und Sie können sie anzeigen und von Webbrowser herunterladen.

In Fenster wählen Sie Aktionen, In Browser öffnen und dann in den Buildergebnissen im Webbrowser, auswählen Diagnose aus.Sie können Protokolle anzeigen auswählen, um ein Menü zu öffnen, in dem Sie das Protokoll auswählen können, das Sie anzeigen möchten, oder, alle herunterzuladen benachrichtigt eine ZIP-Datei an.

Zeigen Sie die Diagnoseprotokolle an

Nachdem Sie den Ablageordner öffnen oder die ZIP-Datei herunterladen, können Sie eines der folgenden Protokolle anzeigen:

Wählen Sie Buildcontroller: ActivityLog
Von jedem Build-Agent, die am Build teilnahm: **ActivityLog.AgentScope.**Build_Agent_ID
Für jede Projektmappe kompiliert durch die MSBuild-Aktivität: Solution_Name

Die beste Möglichkeit, diese Protokolle anzuzeigen, sie auf den Entwickler-Computer kopiert und von dort zu öffnen.

Überprüfen Sie das Buildsystem und debuggen Sie den Buildprozess

Einige Probleme können durch das Buildsystem lokales verursacht werden.

Tipp
Versuchen Sie, den Entwickler-Computer als Buildserver bereitzustellen, damit Sie direkt auf die Umgebung einfach abrufen können, in der der Buildprozess ausgeführt wird.Siehe Bereitstellen und Konfigurieren eines Buildservers.

Überprüfen Sie die Buildsystemkomponenten

Überprüfen Sie, ob der Buildserver, Controller und -Agent ordnungsgemäß konfiguriert werden.Siehe Bereitstellen und Konfigurieren eines Buildservers, Bereitstellen und Konfigurieren eines Buildcontrollers und Bereitstellen und Konfigurieren eines Build-Agents.

Melden Sie sich Buildserver an und überprüfen Sie, ob er ordnungsgemäß funktioniert.Sie können ausführliche Diagnoseinformationen Daten auf dem Buildserver auch anzeigen.Siehe Manage Your Build System.

Debuggen Sie einen Buildprozess auf dem Buildserver

Um die Probleme erkennen, die von benutzerdefinierter Buildvorgang-Aktivitäten oder durch nicht abgefangene Ausnahmen verursacht werden, versuchen den Buildprozess auf dem Buildserver zu debuggen.

Melden Sie sich am Buildserver an.
Ausführung Visual Studio als Administrator.
In Visual Studio in der Menüleiste, wählen Sie Tools, An den Prozess anhängen aus.
Klicken Sie im Dialogfeld An den Prozess anhängen:
1. Ausgewähltes Prozesse aller Benutzer anzeigen.
2. Ausgewähltes TFSBuildServiceHost.exe.
3. Wählen Sie Anfügen aus.
Wählen Sie in der Menüleiste wählen Sie Debuggen, Ausnahmen aus.Klicken Sie im Dialogfeld Ausnahmen ausgewähltes Common Language Runtime-Ausnahmen.Klicken Sie auf OK.
Wählen Sie in der Menüleiste wählen Sie Tools, Optionen aus.Klicken Sie im Dialogfeld Optionen im Strukturbereich, wählen Sie Debugging.In der Liste Allgemein und deaktivieren Sie das Kontrollkästchen Nur meinen Code aktivieren.Klicken Sie auf OK.
In Visual Studio überprüfen Erstellen Sie den Build in die Warteschlange und ob es auf einen Buildcontroller und einen Buildserver ausgeführt wird, die auf dem Buildserver gehostet werden, auf dem Sie den Debugger aktiviert haben.

Sie können Ausnahmen jetzt debuggen, die während des Buildprozesses ausgelöst werden, und auch legen Sie Haltepunkte fest und Debuggen die benutzerdefinierten Buildprozessaktivitäten.Siehe Debuggen in Visual Studio.

Tipps

Während Sie Probleme mit einem Buildvorgang bestimmen, sicherten können Sie und die Teamkollegenprobleme, indem Sie ihn anhalten, bis Sie den Prozess beheben können:
- Bearbeiten Sie die Builddefinition und dann am unteren Rand der Registerkarte Allgemein, wählen Angehalten aus.
- Während die Builddefinition angehalten wird, um die Korrektur für den Buildprozess zu testen, wählen Sie in der Warteschlange stehender Build aus, öffnen Sie das Kontextmenü und wählen Sie Jetzt starten aus.
Wenn Sie glauben, kann eine der Buildsystemkomponenten die Ursachen von einem der Probleme, können Sie einen Buildserver starten, beenden oder neu starten oder einen Controller oder einen Agent nach Bedarf aktivieren oder deaktivieren.Siehe Manage Your Build System.
Häufig beim Versuch, Buildprozessprobleme zu beheben, müssen Sie einen Build mit den gleichen Optionen in die Warteschlange stellen, verschiedene Korrektur wiederholt zu testen.Sie können einen Build schnell erneut versuchen:
- Von Fenster durch Auswählen von Aktionen, Build wiederholen.
- Von Seite Builds in Team Explorer oder von Build Explorer durch Auswählen eines abgeschlossenen Build, das Öffnen des Kontextmenüs und Auswählen von Build wiederholen.