Verwalten des Buildsystems

Sie haben die Buildserver, einschließlich der Buildcontroller und Build-Agents konfiguriert. Sie verfügen über definierte Buildprozesse, um die Anforderungen des Teams zu erfüllen. Das Team ist jetzt dabei, automatisierte Builds auszuführen und zu verwalten, um die Anwendung zu kompilieren und zu testen.

Gelegentlich werden Sie das Buildsystem überwachen und verwalten müssen, wenn Sie z. B. Probleme überprüfen oder das Buildsystem vergrößern.

Erforderliche Berechtigungen

Sie müssen auf dem Buildserver Mitglied der Windows-Administratorgruppe und auf der Teamprojektauflistung Mitglied der Gruppe "Projektauflistungs-Buildadministratoren" sein. Siehe Berechtigungsreferenz für Team Foundation Server.

Was möchten Sie tun?

• Überprüfen des Status, Verwalten und Ändern der Controller und Agents von Visual Studio

• Überprüfen des Status, Verwalten und Ändern des Servers, des Controllers und der Agents aus der Verwaltungskonsole

• Starten, Beenden oder Neustarten eines Buildservers

• Neustarten eines Buildcontrollers oder eines Build-Agents

• Aktivieren oder Deaktivieren eines Controllers oder eines Agents

• Geben Sie die maximale Anzahl gleichzeitig ausgeführter Builds für einen Controller an

• Registrieren eines Buildservers oder Aufheben der Registrierung

• Überwachen der Buildserverintegrität

• Verwenden von Ereignisprotokollen zum Bestimmen von Problemen

• Nächste Schritte

Überprüfen des Status, Verwalten und Ändern der Controller und Agents von Visual Studio

Gelegentlich möchten Sie den Status überprüfen und den Buildcontroller und die Build-Agents verwalten, beispielsweise wenn ein in der Warteschlange stehender Buildprozess nicht startet oder keinen Fortschritt macht. Sie können das alles direkt von Visual Studio aus durchführen.

1. Im Team Explorer von Visual Studio:

   1. Wenn Sie nicht bereits über eine Verbindung mit einem Teamprojekt in der Teamprojektauflistung verfügen, dann stellen Sie eine Verbindung zu dem Teamprojekt her.

   2. Wählen Sie Startseite und dann die Option Builds aus.

2. Wählen Sie auf der Buildsseite die Option Aktionen und dann Buildcontroller verwalten aus.

Nächste Schritte

• Überprüfen des Status der Controller und Agents

  • Wenn der Zustand Verfügbar ist und der Status auf Aktiviert steht, dann wird die Komponente wahrscheinlich ordnungsgemäß ausgeführt.

  • Wenn der Zustand auf Deaktiviert steht, können Sie die Komponente auswählen, dann Eigenschaften auswählen und dann die Komponente erneut aktivieren.

  • Wenn der Status Offline angibt, ist die Komponente getrennt. Melden Sie sich am Buildserver an und stellen Sie sicher, dass er registriert ist und eine Verbindung mit dem Team Foundation Server herstellen kann.

• Anzeigen, Ändern, Aktivieren oder Deaktivieren eines Controllers oder Agents
  Wählen Sie ihn aus und klicken Sie auf Eigenschaften. Weitere Informationen finden Sie dann unter Bereitstellen und Konfigurieren eines Buildcontrollers oder Bereitstellen und Konfigurieren eines Build-Agents.

• Entfernen eines Controllers oder Agents
  Weitere Informationen finden Sie unter Entfernen eines Buildcontrollers oder Entfernen eines Build-Agents.

• Verwalten oder Lösen von Problemen mit einem Buildserver, Controller oder Agents
  Weitere Informationen finden Sie in den Abschnitten weiter unten.

Überprüfen des Status, Verwalten und Ändern des Servers, des Controllers und der Agents aus der Verwaltungskonsole

Wenn Sie die Buildsystemkomponenten überprüfen oder verwalten möchten, benötigen Sie manchmal die zusätzlichen Funktionen, die mit Anmeldung am Buildserver verfügbar werden.

1. Melden Sie sich an dem Buildserver an, den Sie konfigurieren möchten.

2. Führen Sie aus dem Windows-Startmenü heraus die Team Foundation Server-Verwaltungskonsole aus.

   Die Team Foundation-Verwaltungskonsole wird angezeigt.

3. Erweitern Sie im Strukturbereich den Namen des Servers.

4. Wählen Sie den Knoten Buildkonfiguration aus.

Nächste Schritte

• Überprüfen des Status der Controller und Agents

  • Wenn einer der Buildcontroller oder der Build-Agents ein Build verarbeiten, werden Meldungen über die ausgeführten Arbeiten in Echtzeit in der Team Foundation-Verwaltungskonsole angezeigt.

    

    Weitere Informationen zum Überwachen eines laufenden Buildprozesses finden Sie unter Ausführen, Überwachen und Verwalten von Builds und Diagnose von Problemen im Build.

  • Wenn ein Controller oder Agent rot ist, wird die Komponente getrennt. Stellen Sie sicher, dass der Buildserver eine Verbindung mit dem Team Foundation Server herstellen kann.

• Arbeiten mit dem Buildserver

  

  • Wählen Sie zum Starten, Beenden oder Neustarten des Buildservers eine der Optionen Neu starten, Beenden oder Start aus.

  • Wählen Sie Eigenschaften aus, um einen Buildserver bereitzustellen und zu konfigurieren.

  • Wählen Sie zum Registrieren eines Buildservers oder Aufheben der Registrierung entweder die Option Registrieren oder Registrierung aufheben aus.

  • Wählen Sie Ereignisse… aus, um Probleme mithilfe von Ereignisprotokollen zu diagnostizieren.

  • Überwachen der Buildserverintegrität.

• Arbeiten mit dem Buildcontroller
  

  • Wählen Sie Eigenschaften aus. Weitere Informationen finden Sie unter Bereitstellen und Konfigurieren eines Buildcontrollers.

  • Wählen Sie Neu starten zum Neustart des Controllers aus.

  • Wählen Sie Aktivieren oder Deaktivieren zum Aktiveren oder Deaktivieren des Controllers aus.

• Arbeiten mit dem Build-Agent
  

  • Wählen Sie Eigenschaften aus. Weitere Informationen finden Sie unter Bereitstellen und Konfigurieren eines Build-Agents.

  • Wählen Sie Neu starten zum Neustart des Agents aus.

  • Wählen Sie Aktivieren oder Deaktivieren zum Aktivieren oder Deaktivieren des Agents.

Starten, Beenden oder Neustarten eines Buildservers

Das Beenden eines Buildservers empfiehlt sich, wenn darauf Wartungsarbeiten ausgeführt werden. Wählen Sie aus der Team Foundation-Verwaltungskonsole heraus Beenden aus, um die Verbindung aller Buildcontroller und Build-Agents, die auf dem Buildserver gehostet werden, zu trennen. Wählen Sie Start aus, wenn Sie bereit sind, die Controller und Agents wieder zu starten.

Wenn der Buildserver nicht antwortet (beispielsweise, wenn ein Buildvorgang nicht startet oder der Fortschritt zu langsam ist), kann es helfen, Neu starten auszuwählen. Wenn Sie den Buildserver neu starten, wird der Team Foundation-Builddienst-Prozess geschlossen und in einem Zustand erneut gestartet, der nahezu dem eines Computerneustarts entspricht. Buildvorgänge, die gerade vom Buildcontroller oder von einem Build-Agent auf diesem Buildserver verarbeitet werden, werden abgebrochen.

Neustarten eines Buildcontrollers oder eines Build-Agents

Wenn ein Neustart des Buildservers störend oder unnötig ist, können Sie den Neu starten-Link des Buildcontrollers oder des Build-Agents aus der Team Foundation-Verwaltungskonsole auswählen. Wenn Sie einen Buildcontroller neu starten, werden Assemblys neu geladen, und alle von ihm verarbeiteten Builds werden abgebrochen. Wenn Sie einen Build-Agent neu starten, wird die App-Domäne verworfen, Assemblys werden neu geladen und der aktuell verarbeitete Build wird abgebrochen.

Aktivieren oder Deaktivieren eines Controllers oder eines Agents

Sie können einen -Controller oder -Agent deaktivieren, um zu verhindern, dass ihnen Builds zugewiesen werden. Wenn Sie einen Controller oder Agent deaktivieren, der einen Build verarbeitet, wird der Build abgeschlossen, bevor die Komponente deaktiviert wird.

Dadurch können Sie die Funktionsweise Ihres Buildsystems anpassen oder vorübergehend ändern. Beispiel: Sie vermuten, dass auf einem Buildserver zu viele Build-Agents ausgeführt werden, da die Builds zu langsam verarbeitet werden. Sie können einige Build-Agents deaktivieren und prüfen, wie sich dies auf die Leistung auswirkt. Gegebenenfalls können Sie die Build-Agents später wieder aktivieren, sofern erforderlich.

So aktivieren oder deaktivieren Sie einen Build-Agent oder einen Buildcontroller:

• Wählen Sie im Dialogfeld Visual Studio Buildcontroller verwalten den Buildcontroller oder Build-Agent aus, den Sie deaktivieren oder aktivieren möchten, und wählen Sie dann Eigenschaften aus. Entweder das Dialogfeld Buildcontroller-Eigenschaften oder Build-Agent-Eigenschaften wird angezeigt. Deaktivieren oder aktivieren Sie entweder das Kontrollkästchen Der Buildcontrollerdienst ist aktiviert oder das Kontrollkästchen Der Build-Agent-Dienst ist aktiviert.

• Suchen Sie von der Team Foundation-Verwaltungskonsole aus nach dem Buildcontroller oder Build-Agent, den Sie deaktivieren oder aktivieren möchten, und wählen Sie dann den entsprechenden Aktivieren- oder Deaktivieren-Link aus.

Registrieren eines Buildservers oder Aufheben der Registrierung

Wählen Sie in der Team Foundation-Verwaltungskonsole die Option Registrierung aufheben aus, wenn Sie den Buildserver aus dem Buildsystem entfernen möchten. Wenn Sie Registrierung aufheben auswählen, werden Sie gefragt, ob Sie Buildcontroller und Build-Agents löschen möchten, die auf dem Buildserver ausgeführt werden.

• Wählen Sie Nein aus, wenn Sie den Buildserver vorübergehend außer Betrieb setzen möchten. Die Controller und Agents auf dem Buildserver werden nicht aus der Teamprojektauflistung gelöscht und werden mit dem Status Offline im Dialogfeld Visual Studio Buildcontroller verwalten angezeigt. Wenn Sie später Registrieren auswählen, können Sie den Buildcontroller und die Build-Agents wiederherstellen.

• Wählen Sie Ja aus, wenn Sie alle Konfigurationseinstellungen für diesen Build aus der Teamprojektauflistung löschen möchten. Alle Informationen zu den Buildcontrollern und Build-Agents werden gelöscht.

Wenn die Meldung Der Builddienst ist nicht registriert angezeigt wird, können Sie Registrieren auswählen, um den Buildserver wieder in Betrieb zu setzen, sodass Buildcontroller und Build-Agents gehostet werden können.

Überwachen der Buildserverintegrität

Während Sie beim Buildserver angemeldet sind, können Sie bestätigen, dass Team Foundation-Builddienst ausgeführt wird, Informationen über die verwendeten Ressourcen erhalten und die allgemeine Integrität des Buildservers bestätigen.

1. Windows Task-Manager ausführen (Task-Manager auf Windows 8).

2. Klicken Sie auf Windows 8. Wenn der Link Weitere Details angezeigt wird, wählen Sie ihn aus.

3. Wählen Sie die Registerkarte Prozess aus.

4. Stellen Sie bei allen Versionen von Windows außer Windows 8 sicher, dass Prozesse aller Benutzer anzeigen ausgewählt ist.

5. Auf welcher Version von Windows wird der Buildserver ausgeführt?

   • Windows 8: Suchen Sie den Prozess vom Visual Studio Team Foundation-Builddiensthost. Er muss sich im Bereich Hintergrundprozesse befinden, oder wenn der Buildserver im interaktivem Modus ausgeführt wird, im Bereich Apps. Beachten Sie die CPU, den Arbeitsspeicher, den Datenträger und die Netzwerkressourcen, die der Prozess verwendet.

   • Eine andere Windows-Version: Suchen Sie den Prozess TFSBuildServiceHost.exe. Beachten Sie die CPU- und Arbeitsspeicherressourcen, die der Prozess verwendet.

6. Verwenden Sie die anderen Registerkarten im Task-Manager, um die allgemeinen Integrität des Buildservers zu bestätigen. Beispielsweise können Sie die Registerkarte Leistung auswählen, um zu bestätigen, dass der Computer über genügend Prozessor- und Speicherressourcen verfügt. Sie können den Ressourcenmonitor auswählen (auf Windows 8 die Option Ressourcenmonitor öffnen).

Verwenden von Ereignisprotokollen zum Bestimmen von Problemen

Verwenden Sie die Ereignisanzeige, um Informationen abzurufen, die Ihnen dabei helfen können, die Funktionsweise des Buildservers zu überwachen und Probleme mit dem Buildserver oder dem Buildprozess zu bestimmen.

Anzeigen aktueller Ereignisse

Beginnen Sie, indem Sie die letzten Ereignisse untersuchen. Wählen Sie in der Team Foundation-Verwaltungskonsole die Option Ereignisse… aus, um die Ereignisanzeige zu öffnen und die letzten Informationsmeldungen, Warnungen und Fehlermeldungen anzuzeigen.

Anzeigen des Betriebsprotokolls

Um über einen längeren Zeitraum ausführlichere Informationen zu erhalten, erweitern Sie in der Ereignisanzeige im Strukturbereich die Optionen Anwendungs- und Dienstprotokolle, Microsoft, Team Foundation Server, Builddienste, und wählen Sie dann Betriebsbereit aus.

Anzeigen des analytischen Protokolls

In den meisten Fällen ist es nicht notwendig, die internen Meldungen zu lesen, die durch das Analyseprotokoll verfügbar gemacht werden. Allerdings sind diese Daten nützlich, wenn Sie mit dem Produktsupport zusammenarbeiten, um ein Problem zu beheben.

So aktivieren Sie das analytische Protokoll

1. Wählen Sie in der Ereignisanzeige Ansicht, Analytische und Debugprotokolle einblenden aus.

2. Erweitern Sie im Strukturbereich die Optionen Anwendungs- und Dienstprotokolle, Microsoft, Team Foundation Server, Builddienste, und wählen Sie dann Analytisch aus.

3. Öffnen Sie bei ausgewählter Analytisch-Option das Kontextmenü, und wählen Sie dann Aktivieren aus.

Anpassen und Anzeigen der Daten

Um die Daten in einer Ablagedatei zu speichern, die einfach zu überprüfen und anzuzeigen ist, wählen Sie im Strukturbereich einen der oben beschriebenen Knoten aus, öffnen Sie das Kontextmenü, und wählen Sie dann Alle Ereignisse speichern… aus. Verwenden Sie das Dialogfeld Speichern unter, um die Daten in dem Format zu speichern, das Ihren Anforderungen entspricht.

Nächste Schritte

• Bereitstellen und Arbeiten mit einem Buildserver
  Um Team Foundation Build mit einem lokalen Team Foundation Server zu verwenden, müssen Sie mindestens einen Buildserver bereitstellen. Der Server kann auf einem physischen Computer oder einem virtuellen Computer bereitgestellt werden.

• Bereitstellen und Konfigurieren eines Buildcontrollers
  Verwenden Sie einen Buildcontroller, um einfache Aufgaben auszuführen und die prozessorintensiven Arbeiten des Buildprozesses auf seinen Build-Agentpool zu verteilen. Sie können auf einem Buildserver einen Buildcontroller hosten.

• Bereitstellen und Konfigurieren von Build-Agents
  Verwenden Sie einen Build-Agent für die prozessorintensiven Arbeiten des Builds. Hierzu zählt das Abrufen von Dateien aus der Versionskontrolle, das Bereitstellen des Arbeitsbereichs, das Kompilieren des Codes sowie das Ausführen von Tests. Auf einem Buildserver können mehrere Build-Agents gehostet werden.

• Einrichten von Ablageordnern
  Sie können einen oder mehrere Ablageordner vorbereiten und dann festlegen, damit dem Team Binärdateien, Testergebnisse und Protokolldateien durch das Buildsystem bereitgestellt werden können.

• Horizontale Skalierung des Team Foundation Buildsystems
  In dem Maße, in dem das Team und die CodeBase wächst, können Sie das Buildsystem relativ einfach schrittweise erweitern.