Bereitstellen und Konfigurieren eines Buildcontrollers

Zur Verwendung von Team Foundation Build, muss Ihr Team über mindestens einen Buildcontroller verfügen, um einfache Aufgaben auszuführen, und die prozessorintensiven Arbeiten des Buildprozesses über einen Pool von Build-Agents zu verteilen.

Einzelcomputersystem (eigenständig)

Jeder Buildcontroller ist einer bestimmten Teamprojektauflistung fest zugewiesen. Der Buildcontroller führt einige einfache Aufgaben aus, z. B. das Ermitteln des Namens für den Build, das Erstellen der Bezeichnung in der Versionskontrolle, das Protokollieren von Hinweisen und das Melden des Status aus dem Build. Der Buildcontroller verwendet die AgentScope-Aktivität, um prozessorintensive Arbeiten, wie das Kompilieren von Code oder das Durchführen von Tests, auf die Build-Agents innerhalb des Pools zu delegieren. Diese Build-Agents können entweder auf demselben Buildserver oder auf einem anderen Buildserver gehostet werden.

Da ein Buildcontroller in der Regel viel Prozessorzeit erfordert, können Sie ihn in vielen Fällen, wie weiter oben veranschaulicht, auf dem gleichen Computer wie den Team Foundation Server hosten oder auf einem physischen oder virtuellen Computer mit geringer Leistung.

Ein Buildcontroller kann in bestimmten Situationen jedoch viel Speicherplatz benötigen. Daher sollten Sie nach Bedarf genügend Arbeitsspeicher bereitstellen, um sicherzustellen, dass er ordnungsgemäß funktioniert. Abhängig von den Anforderungen und Ressourcen des Teams, sollten Sie den Buildcontroller allerdings auf einem anderen Computer als dem Team Foundation Server ausführen.

Zwei Buildserver

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?

  • Erstellen oder Ändern eines Buildcontrollers.

  • Aktivieren der Buildprozesse zum Verwenden zusätzlicher Binärdateien

  • Festlegen der maximalen Anzahl gleichzeitig ausgeführter Builds

  • Entfernen eines Buildcontrollers

  • Verwenden eines Buildcontrollers mit einer Teamprojektauflistung, die auf Visual Studio Online gehostet wird

Erstellen oder Ändern eines Buildcontrollers.

So erstellen oder ändern Sie einen Buildcontroller auf dem Buildserver

  1. Melden Sie sich am Buildserver an.

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

  3. Erweitern Sie im Strukturbereich der Team Foundation-Verwaltungskonsole den Namen des Servers, und wählen Sie dann den Knoten Buildkonfiguration aus.

    Hinweis

    Wenn die Meldung Installierte Funktionen konfigurierenInstallierte Funktionen konfigurieren angezeigt wird, siehe Bereitstellen eines Buildservers.

  4. Führen Sie auf der Buildkonfigurations-Seite folgende Schritte durch:

    • Wenn ein Controller nicht aufgeführt wird, wählen Sie die Option Neuer Controller aus.

    • Wenn ein Controller bereits aufgeführt wird führen Sie folgende Schritte aus:

      Buildcontroller

      Wählen Sie Eigenschaften aus.

    Das Dialogfeld Eigenschaften von Buildcontroller wird angezeigt.

So ändern Sie einen Buildcontroller aus Visual Studio

  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 Symbol "Startseite" Startseite und dann die Option Symbol "Builds" Builds aus.

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

    Das Dialogfeld Buildcontroller verwalten wird angezeigt.

    Dialogfeld "Buildcontroller verwalten"

  3. Wählen Sie den zu ändernden Buildcontroller aus, und wählen Sie anschließend Eigenschaften aus.

    Das Dialogfeld Eigenschaften von Buildcontroller wird angezeigt.

Dialogfeld "Eigenschaften von Buildcontroller"

In den Feldern Anzeigename und Beschreibung: Geben Sie einen Namen und eine Beschreibung ein, mit deren Hilfe Teammitglieder beim Definieren der Buildprozesse den entsprechenden Buildcontroller identifizieren können.

Weitere Informationen zum Konfigurieren des Buildcontrollers finden Sie in den Abschnitten weiter unten.

Aktivieren der Buildprozesse zum Verwenden zusätzlicher Binärdateien

Sie können den Buildprozess so aktivieren, dass Binärdateien unterstützt werden, die Sie auf Ihren Team Foundation Server hochgeladen haben, beispielsweise:

Damit die Buildprozesse diese Arten von Code nutzen können, laden Sie die Binärdateien in den Ordner (oder einem seiner Unterordner) hoch, den Sie im Feld Versionskontrollpfad zu benutzerdefinierten Assemblys angegeben haben. Wenn Sie den Wert in diesem Feld festlegen oder ändern, wird der Buildservers zum laden der Assemblys automatisch neu gestartet.

Tipp

Wenn die Buildergebnisse eine TF215097-Fehlermeldung enthalten, umfasst der Buildprozess möglicherweise eine benutzerdefinierte Aktivität, die sich nicht in diesem Ordner oder einem der Unterordner befindet.

Festlegen der maximalen Anzahl gleichzeitig ausgeführter Builds

In den meisten Fällen empfiehlt es sich, diesen Wert auf Aktivierte Agent-Anzahl als Standard verwenden zu belassen. In einigen Fällen sollten Sie die Tiefe der Buildwarteschlange steuern. Beispiel:

  • Sie bemerken, dass zu viele Builds den Status Ausgeführt anzeigen, obwohl viele davon blockiert sind, da sie auf die Zuweisung eines Build-Agents warten. Diese Situation kann das Team durcheinander bringen. Um das Problem zu vermeiden, wählen Sie Maximum angeben aus und geben einen Wert an, der unter der Anzahl der unter dem Buildcontroller zusammengefassten Build-Agents liegt.

  • Sie entwerfen eine benutzerdefinierte Buildvorlage, damit die Builds mehr als einen Build-Agent aus einem Pool von 12 Build-Agents unter dem Buildcontroller auf einmal nutzen können. Die von diesem Buildcontroller verarbeiteten Builds basieren auf einer benutzerdefinierten Buildvorlage, von der drei Build-Agents gleichzeitig übertragen werden. Wenn Sie für den Buildcontroller unter Maximale Anzahl gleichzeitig ausgeführter Builds nun beispielsweise die Option Maximum angeben auf den Wert "4" festlegen, können Sie eine nützlichere Verwendung der Buildwarteschlange erreichen.

Entfernen eines Buildcontrollers

  1. Öffnen Sie in Visual Studio das Dialogfeld Buildcontroller verwalten, wie weiter oben in Ändern eines Buildcontrollers aus Visual Studio erläutert.

  2. Wählen Sie alle Build-Agents unter dem Buildcontroller aus und entfernen Sie sie, indem Sie entweder die Option Entfernen auswählen oder indem Sie Eigenschaften auswählen und dann das Dialogfeld Eigenschaften von Build-Agent verwenden, um den Build-Agent einem anderen Buildcontroller zuzuweisen.

  3. Wählen Sie auf den zu entfernenden Buildcontroller aus, und wählen Sie anschließend Entfernen aus.

Hinweis

Sie können auch die Team Foundation-Verwaltungskonsole dazu verwenden, den Buildcontroller zu entfernen, während Sie am Buildserver angemeldet sind.Wenn Sie das allerdings tun, müssen Sie möglicherweise dennoch Visual Studio verwenden, oder sich zuerst auf einem anderen Buildserver anmelden, um alle Remote- Build-Agent, die vom Buildcontroller zusammengefasst wurden, zu entfernen.

Verwenden eines Buildcontrollers mit einer Teamprojektauflistung, die auf Visual Studio Online gehostet wird

Verwenden des gehosteten Buildcontrollers: Wenn die Teamprojektauflistung auf Visual Studio Online gehostet wird, können Sie das Bereitstellen eines eigenen Buildcontrollers eventuell überspringen und stattdessen den gehosteten Buildcontroller verwenden. Um den Gehosteten Buildcontroller zu verwenden, wählen Sie ihn beim Definieren des Buildprozess einfach aus. Siehe Verwenden des gehosteten Buildcontrollers.

Verwenden eines lokalen Buildcontrollers: Wenn für den Buildprozess Ressourcen jenseits der Funktionen des gehosteten Buildcontrollers erforderlich sind, können Sie eine Verbindung zwischen dem lokalen Buildcontroller und der gehosteten Teamprojektauflistung herstellen.

Team Foundation Service, lokaler Buildserver

Nächste Schritte

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

  • 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.

  • Ein Buildsystem verwalten
    Nachdem Sie den Buildserver bereitgestellt haben, können Sie ihn von der Team Foundation-Verwaltungskonsole aus verwalten. Sie können den Buildcontroller und die Build-Agents entweder über die Team Foundation-Verwaltungskonsole oder aus Visual Studio heraus verwalten.

  • Definieren des Buildprozesses
    Nachdem das Buildsystem erstellt ist, sind Sie bereit, den Buildprozesses zu definieren, der die Anweisungen darüber enthält, welche Codeprojekte kompiliert werden sollen, welche Aktionen einen Buildvorgang auslösen und welche Tests ausgeführt werden sollen. Außerdem sollten alle anderen Verfahren enthalten sein, die das Team benötigt.