Share via


Erstellen und Verwenden eines Buildcontrollers

Zum Verwenden von Team Foundation Build muss das Team über mindestens einen Buildcontroller verfügen, von dem die Dienste mindestens eines Build-Agents zusammengefasst und verwaltet werden. Von diesem Controller werden zwar einige Aufgaben ausgeführt, prozessorintensive Arbeiten wie das Kompilieren von Code oder das Durchführen von Tests werden allerdings auf die Build-Agents innerhalb des Pools verteilt. Jeder Buildcontroller ist einer bestimmten Teamprojektsammlung fest zugewiesen.

Vorbereitung:

  • Informieren Sie sich über die Rolle der Buildcontrollers in einem Buildsystem sowie über die unterschiedlichen Einsatzmöglichkeiten. Weitere Informationen finden Sie unter Informationen zum Team Foundation-Buildsystem.

  • Ein Buildcontroller wird auf einem Buildcomputer gehostet. Daher muss zunächst ein Buildcomputer konfiguriert werden, bevor ein Buildcontroller erstellt und verwendet werden kann. Jeder Buildcomputer kann einen einzelnen Buildcontroller hosten. Weitere Informationen finden Sie unter Konfigurieren eines Buildcomputers.

In diesem Thema

  • Erforderliche Berechtigungen

  • Erstellen eines Buildcontrollers

  • Ändern eines Buildcontrollers

  • Dialogfeld "Eigenschaften von Buildcontroller"

  • Entfernen eines Buildcontrollers

Erforderliche Berechtigungen

Zum Ausführen dieser Prozedur müssen Sie auf dem Buildcomputer Mitglied der Gruppe Administratoren sein, und in Visual Studio Team Foundation Server muss die Berechtigung Buildressourcen verwalten auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Erstellen eines Buildcontrollers

So erstellen Sie einen Buildcontroller

  1. Melden Sie sich an dem Buildcomputer an, auf dem Sie den Buildcontroller erstellen möchten.

  2. Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.

    Die Team Foundation-Verwaltungskonsole wird angezeigt.

  3. Erweitern Sie im Strukturbereich den Namen des Servers.

  4. Klicken Sie auf den Knoten Buildkonfiguration.

    Im Inhaltsbereich werden Informationen zum Buildcomputer angezeigt.

    Wenn die Meldung Der Builddienst wurde für… konfiguriert oder die Meldung Der Builddienst ist nicht registriert angezeigt wird, gehen Sie wie unter Konfigurieren eines Buildcomputers beschrieben vor.

  5. Wird im Inhaltsbereich der Link Neuer Controller angezeigt, klicken Sie auf den Link.

  6. (Optional) Klicken Sie direkt unter dem Namen des Buildcontrollers auf Eigenschaften, um verschiedene Eigenschaften des Buildcontrollers zu ändern.

    Das Dialogfeld Eigenschaften von Buildcontroller wird angezeigt. Weitere Informationen finden Sie unter Eigenschaften von Buildcontroller weiter unter in diesem Thema.

  7. Wird direkt unter dem Namen des Buildcontrollers der Link Starten angezeigt, klicken Sie auf den Link.

Ändern eines Buildcontrollers

Ein Buildcontroller kann entweder von einem Clientcomputer aus oder direkt auf dem Buildcomputer, von dem der Buildcontroller gehostet wird, geändert werden.

So ändern Sie einen Buildcontroller von einem Clientcomputer aus

  1. Öffnen Sie in Visual Studio das Menü Build, und klicken Sie auf Buildcontroller verwalten.

    Das Dialogfeld Buildcontroller verwalten wird angezeigt.

  2. Wählen Sie den zu ändernden Buildcontroller aus, und klicken Sie anschließend auf Eigenschaften.

    Das Dialogfeld Eigenschaften von Buildcontroller wird angezeigt.

So ändern Sie einen Buildcontroller auf dem Buildcomputer

  1. Melden Sie sich an dem Buildcomputer an, auf dem der zu ändernde Buildcontroller ausgeführt wird.

  2. Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.

    Die Team Foundation-Verwaltungskonsolewird angezeigt.

  3. Erweitern Sie im Strukturbereich den Namen des Servers.

  4. Klicken Sie auf den Knoten Team Foundation-Build.

  5. Klicken Sie direkt unter dem Namen des zu ändernden Buildcontrollers auf Eigenschaften.

    Das Dialogfeld Eigenschaften von Buildcontroller wird angezeigt.

Dialogfeld "Eigenschaften von Buildcontroller"

Im Dialogfeld Eigenschaften von Buildcontroller können Sie neben dem Anzeigenamen und der Beschreibung auch andere Eigenschaften anzeigen oder ändern, die sich auf die Funktionsweise des Buildcontrollers auswirken.

Anzeigename, Beschreibung

Geben Sie einen aussagekräftigen Namen und eine Beschreibung an, damit die Benutzer den Buildcontroller problemlos identifizieren können und wichtige Informationen zum Buildcontroller erhalten. Dank dieser Werte können die Mitglieder Ihres Teams beispielsweise beim Definieren eines Builds einfacher den korrekten Buildcontroller angeben.

Computername

Dieses Feld enthält den Namen des Buildcomputers, von dem der Buildcontroller gehostet wird.

Pfad in der Versionskontrolle zu benutzerdefinierten Assemblys

Mit diesem Feld können Sie für Ihre Builds die Nutzung der folgenden Arten von Assemblys ermöglichen:

  • Assemblys mit benutzerdefinierten Workflowaktivitäten

  • Benutzerdefinierte MSBuild-Aufgaben

Sie können diese Art von Code in jeden Ordner einchecken, bei dem es sich um ein Nachfolgerelement des Ordners handelt, der in diesem Feld angegeben wurde.

Tipp

Nach dem Festlegen oder Ändern dieses Werts wird Team Foundation-Builddienst automatisch neu gestartet, um die neuen Assemblys zu laden.

Maximale Anzahl gleichzeitig ausgeführter Builds

Mithilfe dieses Felds können Sie die Tiefe der Buildwarteschlange steuern. In den meisten Fällen empfiehlt es sich, diesen Wert auf Agent-Anzahl als Standard verwenden zu belassen.

Manchmal besitzen jedoch möglicherweise zu viele Builds den Status Ausgeführt, obwohl viele von ihnen blockiert sind, da sie auf die Zuweisung eines Build-Agents warten. Dies kann sich für das Team als verwirrend erweisen. In einer solchen Situation empfiehlt es sich unter Umständen, auf Maximum angeben zu klicken und einen Wert anzugeben, der unter der Anzahl von Build-Agents liegt, die unter dem Buildcontroller zusammengefasst sind.

Angenommen, Sie entwerfen eine benutzerdefinierte Buildvorlage, um den Builds die gleichzeitige Nutzung mehrerer Build-Agents zu ermöglichen. Sie verfügen über 12 unter dem Buildcontroller zusammengefasste Build-Agents. Die von diesem Buildcontroller verarbeiteten Builds basieren auf einer benutzerdefinierten Buildvorlage, von der zur Verarbeitung des Builds drei Build-Agents gleichzeitig verwendet 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 genauere Darstellung der Buildwarteschlange erreichen.

Der Buildcontrollerdienst ist aktiviert

Aktivieren Sie dieses Kontrollkästchen, um den Buildcontroller zu aktivieren, oder deaktivieren Sie es, um den Buildcontroller zu deaktivieren und dafür zu sorgen, dass ihm keine Builds zugewiesen werden.

Tipp

Einige Probleme können vermieden werden, indem ein Buildcontroller bei Wartungsarbeiten auf dem Buildcomputer deaktiviert wird.

Entfernen eines Buildcontrollers

Ein Buildcontroller kann entweder mithilfe eines Clientcomputers oder direkt vom Buildcomputer aus, von dem der Buildcontroller gehostet wird, entfernt werden.

Hinweis   Team Foundation-Builddienst wird auf dem Buildcomputer nicht deinstalliert, wenn Sie den Buildcontroller entfernen.

So entfernen Sie einen Buildcontroller mithilfe eines Clientcomputers

  1. Klicken Sie in Visual Studio im Menü Build auf Buildcontroller verwalten.

    Das Dialogfeld Buildcontroller verwalten wird angezeigt.

  2. Klicken Sie auf den zu entfernenden Buildcontroller und anschließend auf Entfernen.

So entfernen Sie einen Buildcontroller vom Buildcomputer

  1. Melden Sie sich an dem Buildcomputer an, auf dem der zu ändernde Buildcontroller ausgeführt wird.

  2. Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.

    Die Team Foundation-Verwaltungskonsolewird angezeigt.

  3. Erweitern Sie im Strukturbereich den Namen des Servers.

  4. Klicken Sie auf den Knoten Team Foundation-Build.

  5. Klicken Sie direkt unter dem Namen des zu entfernenden Buildcontrollers auf Entfernen.

Siehe auch

Weitere Ressourcen

Definieren des Buildprozesses