Erstellen und Verwenden von Build-Agents
Zur Verwendung von Team Foundation Build muss Ihr Team über mindestens einen Build-Agent verfügen. Von einem Build-Agent werden die prozessorintensiven Arbeiten des Builds ausgeführt. Hierzu zählt das Abrufen von Dateien aus der Versionskontrolle, das Bereitstellen des Arbeitsbereichs, das Kompilieren des Codes, das Ausführen von Tests sowie das Zusammenführen von Dateien in der Versionskontrolle. Jeder Build-Agent ist einem einzelnen Buildcontroller fest zugeordnet und wird von diesem gesteuert.
Vor der Installation
Informieren Sie sich über die Rolle der Build-Agents in einem Buildsystem sowie über die unterschiedlichen Einsatzmöglichkeiten. Weitere Informationen finden Sie unter Informationen zum Team Foundation-Buildsystem.
Ein Build-Agent wird auf einem Buildcomputer gehostet. Daher muss zunächst ein Buildcomputer konfiguriert werden, bevor ein Build-Agent erstellt und verwendet werden kann. Jeder Buildcomputer kann einen oder mehrere Build-Agents hosten. Weitere Informationen finden Sie unter Konfigurieren eines Buildcomputers.
In diesem Thema
Erforderliche Berechtigungen
Erstellen eines Build-Agents
Ändern eines Build-Agents
Dialogfeld "Eigenschaften von Build-Agent"
- Weitere Informationen zur Eigenschaft "Arbeitsverzeichnis"
Verwenden des Build-Agents zum Ausführen von Tests
Installieren von zusätzlicher Software
Installieren von erforderlicher Software zum Kompilieren von Code
Installieren von erforderlicher Software zum Ausführen anderer Aufgaben
Zuweisen von Tags zu einem Build-Agent
Entfernen eines Build-Agents
Erforderliche Berechtigungen
Zum Ausführen dieser Prozedur müssen Sie auf dem Buildcomputer Mitglied der Gruppe Administratoren sein, und die Berechtigung Buildressourcen verwalten muss auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Erstellen eines Build-Agents
So erstellen Sie einen Build-Agent
Melden Sie sich an dem Buildcomputer an, auf dem Sie den Build-Agent erstellen möchten.
Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.
Die Team Foundation-Verwaltungskonsolewird angezeigt.
Erweitern Sie im Strukturbereich den Namen des Servers, und klicken Sie dann auf den Knoten Team Foundation-Build.
Im Inhaltsbereich werden Informationen zum Buildcomputer angezeigt.
Wenn die Meldung Der Builddienst wurde für… konfiguriert nicht angezeigt wird, gehen Sie wie unter Konfigurieren eines Buildcomputers beschrieben vor.
Klicken Sie auf Neuer Agent.
Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt. Weitere Informationen finden Sie unter Dialogfeld "Eigenschaften von Build-Agent" weiter unter in diesem Thema.
Klicken Sie nach dem Ändern der Eigenschaften des Agents auf OK.
Wenn der Link Starten direkt unter dem Namen des Build-Agents angezeigt wird, klicken Sie auf den Link.
Ändern eines Build-Agents
Sie können einen Build-Agent sowohl von einem Clientcomputer aus als auch direkt auf dem Buildcomputer ändern, von dem der Build-Agent gehostet wird.
So ändern Sie einen Build-Agent von einem Clientcomputer aus
Öffnen Sie in Visual Studio das Menü Build, und klicken Sie anschließend auf Buildcontroller verwalten.
Das Dialogfeld Buildcontroller verwalten wird angezeigt.
Klicken Sie auf den zu ändernden Build-Agent und anschließend auf Eigenschaften.
Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt.
So ändern Sie einen Build-Agent auf dem Buildcomputer
Melden Sie sich an dem Buildcomputer an, auf dem der zu ändernde Build-Agent ausgeführt wird.
Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.
Die Team Foundation-Verwaltungskonsolewird angezeigt.
Erweitern Sie im Strukturbereich den Namen des Servers, und klicken Sie anschließend auf den Knoten Team Foundation-Build.
Klicken Sie direkt unter dem Namen des zu ändernden Build-Agents auf Eigenschaften.
Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt.
Dialogfeld "Eigenschaften von Build-Agent"
Im Dialogfeld Eigenschaften von Build-Agent können Sie neben dem Anzeigenamen und der Beschreibung auch andere Eigenschaften anzeigen oder ändern, die sich auf die Funktionsweise des Build-Agents auswirken.
Anzeigename, Beschreibung
Geben Sie einen aussagekräftigen Namen und eine Beschreibung an, damit die Teammitglieder den Build-Agent problemlos identifizieren können und wichtige Informationen zum Build-Agent erhalten.
Controller
Geben Sie den Buildcontroller an, von dem dieser Build-Agent gesteuert werden soll. Der Buildcontroller kann auf dem gleichen Buildcomputer ausgeführt werden wie der Build-Agent, er kann aber auch auf einem anderen Buildcomputer ausgeführt werden.
Computername
Dieses Feld enthält den Namen des Buildcomputers, von dem der Build-Agent gehostet wird.
Arbeitsverzeichnis
Geben Sie in diesem Feld den Pfad zum Arbeitsverzeichnis an. Weitere Informationen finden Sie unter Weitere Informationen zur Eigenschaft "Arbeitsverzeichnis".
Der Build-Agent-Dienst ist aktiviert.
Aktivieren Sie dieses Kontrollkästchen, um den Build-Agent zu aktivieren, oder deaktivieren Sie es, um den Build-Agent zu deaktivieren und dafür zu sorgen, dass ihm keine Builds zugewiesen werden.
Tipp
Die Deaktivierung eines Build-Agents empfiehlt sich, wenn auf dem Buildcomputer Wartungsarbeiten ausgeführt werden.
Weitere Informationen zur Eigenschaft "Arbeitsverzeichnis"
Das Arbeitsverzeichnis wird vom Build-Agent für Operationen mit Lese- oder Schreibvorgängen verwendet. Beispiel: Quelldateien werden in Unterverzeichnisse dieses Ordners kopiert, und Binärdateien werden erstellt und in anderen Unterverzeichnissen des Ordners gespeichert.
Arbeitsverzeichnistoken
Zwar kann für die Eigenschaft Arbeitsverzeichnis auch ein exakter Pfad (beispielsweise "c:\temp\build\") angeben werden, ein flexiblerer Ansatz ist jedoch die Verwendung von Tokens in der Pfadangabe. Zwei Arten von Tokens stehen zur Verfügung:
Umgebungsvariablen: Umgebungsvariablen enthalten Informationen zur Umgebung für das System sowie zum angemeldeten Benutzer.
Beispiel: Sie haben das Element Team Foundation-Builddienst so konfiguriert, dass es unter einem Konto mit der Bezeichnung "BuildSvcAcct" ausgeführt wird. Sie geben für einen Build-Agent auf einem Buildcomputer unter Windows Server 2008 $(HomeDrive)\Builds als Arbeitsverzeichnis an. Somit wird als Arbeitsverzeichnis des Build-Agents in der Regel ein physisches Verzeichnis verwendet, das in etwa dem folgenden Speicherort entspricht: C:\Builds.
Tipp
Öffnen Sie zum Aufführen der Umgebungsvariablen auf dem Buildcomputer eine Eingabeaufforderung, und geben Sie set ein.
Team Foundation-Build-Variablen: Folgende Variablen können im Arbeitsverzeichnis eines Build-Agents verwendet werden:
$(BuildAgentId): Eine automatisch generierte ganze Zahl, durch die ein Build-Agent innerhalb einer Teamprojektsammlung eindeutig identifiziert wird.
$(BuildAgentName): DerAnzeigename des Build-Agents.
$(BuildDefinitionId): Eine automatisch generierte ganze Zahl, durch die eine Builddefinition innerhalb einer Teamprojektsammlung eindeutig identifiziert wird.
$(BuildDefinitionPath): Der Teamprojektname und der Builddefinitionsname, getrennt durch einen umgekehrten Schrägstrich.
Arbeitsverzeichnis – Beispiel
Angenommen, Sie verfügen über einen Build-Agent mit der Bezeichnung "BuildBot3". Sie haben im Teamprojekt "CoolApp" zwei Builds mit der Bezeichnung "NightlyBuild" bzw. "WeeklyBuild" definiert. Im Feld Arbeitsverzeichnis geben Sie den folgenden Wert an: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). Dadurch werden vom Build-Agent "BuildBot3" die beiden folgenden Arbeitsverzeichnisse erstellt und verwendet:
C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild
C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild
Achten Sie darauf, dass das Arbeitsverzeichnis nicht zu lang ist.
Die Angabe des Arbeitsverzeichnisses darf nicht zur Erstellung eines physischen Pfads mit einer Länge von mehr als 259 Zeichen führen. Andernfalls schlagen die Builds fehl, und der folgende Fehler wird protokolliert: TF10128: Der PfadPhysischer_Pfad enthält mehr als die zulässigen 259 Zeichen. Geben Sie einen kürzeren Pfad ein, oder wählen Sie ihn aus. Dieser Fehler überrascht Sie vielleicht, wenn Sie die vom Build-Agent erstellten physischen Pfade für gewöhnlich nicht beachten.
Geben Sie zum Beheben dieses Problems ein Arbeitsverzeichnis an, durch das sich ein kürzerer physischer Pfad ergibt. So können Sie beispielsweise das Verzeichnis "$(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID)" angeben, um ein Arbeitsverzeichnis zu erhalten, das in etwa dem folgenden Pfad entspricht: c:\bld\3\2\.
Im Arbeitsverzeichnis erstellte Unterverzeichnisse
Vom Build-Agent werden unter diesem Pfad die folgenden Unterverzeichnisse erstellt und verwendet:
Unterverzeichnis |
Gespeicherte Dateien |
|---|---|
Sources |
Vom Build-Agent gelesene Dateien (beispielsweise Quelldateien). Die Dateien, die heruntergeladen werden, werden in den Arbeitsbereichseinstellungen für jede Builddefinition angegeben. Weitere Informationen finden Sie unter Arbeiten mit Buildarbeitsbereichen. |
Binaries |
Vom Build-Agent kompilierte Dateien (beispielsweise kompilierte Anwendungsdateien). |
TestResults |
Dateien, die von beliebigen, durch den Build-Agent ausgeführten Tests erstellt wurden. |
Verwenden des Build-Agents zum Ausführen von Tests
Sie können einen Buildprozess entwerfen, der einen oder mehrere automatisierte Tests ausführt. Wie die folgende Tabelle zeigt, erfordern einige Tests und Testvorgänge einen Build-Agent, der besondere Anforderungen erfüllt.
Testtyp |
Visual Studio 2010 muss auf dem Buildcomputer installiert sein |
Andere Anforderungen und Informationen |
|---|---|---|
Codeabdeckung |
Ja |
Keine |
Tests der codierten UI |
Ja |
Der Buildcomputer muss als interaktiver Prozess ausgeführt werden. Weitere Informationen zum Einrichten eines solchen Buildcomputers finden Sie unter Konfigurieren eines Buildcomputers. Weitere Informationen zu diesen Tests finden Sie unter Testen der Benutzeroberfläche mit automatisierten UI-Tests. |
Generierung von Datenbanktestdaten |
Nein |
Keine |
Datenbankkomponententests |
Ja |
Keine |
Generische Tests |
Nein |
Keine Weitere Informationen finden Sie unter Erstellen eines automatisierten Tests, der eine ausführbare Datei ausführt, mithilfe generischer Tests. |
Auslastungstests |
Ja |
Keine Weitere Informationen finden Sie unter Einrichten der Testlaufreihenfolge mit Testreihen. |
MSTest-Komponententests |
Nein |
Keine |
Testreihen |
Nein |
Keine |
Testauswirkungsanalyse |
Nein |
Keine |
Webtests |
Ja |
Keine |
Weitere Informationen zum Definieren eines Buildprozesses, der Tests ausführt, finden Sie unter Verwenden des Buildsystems zum Arbeiten mit Tests.
Installieren von zusätzlicher Software
Möglicherweise muss auf dem Buildcomputer zusätzliche Software installiert werden, damit bestimmte Aufgaben vom Build-Agent ausgeführt werden.
Installieren von erforderlicher Software zum Kompilieren von Code
Für die meisten üblichen Projekte ist keine zusätzliche Software erforderlich. So kann vom Build-Agent beispielsweise ohne Installation zusätzlicher Software eine grundlegende Visual C# WPF-Anwendung kompiliert werden.
Zum Kompilieren anderer Projektarten muss jedoch zusätzliche Software installiert werden. So müssen Sie beispielsweise Visual Studio installieren, um ein Setup-Projekt zu kompilieren.
So stellen Sie sicher, dass Ihre Projekte vom Build-Agent kompiliert werden können
Installieren Sie die Version und Edition von Visual Studio, die das Team auf dem Buildcomputer verwendet, auf dem der Build-Agent ausgeführt wird.
Installieren Sie sämtliche andere Software und alle Komponenten, die in Ihrer Entwicklungsumgebung installiert sind und zum Erstellen der Anwendung erforderlich sind.
Installieren von erforderlicher Software zum Ausführen anderer Aufgaben
Zum Ausführen verschiedener anderer Aufgaben durch einen Build-Agent muss auf dem Buildcomputer unter Umständen zusätzliche Software installiert werden. Die folgenden Tabelle gibt Aufschluss über einige allgemeine Build-Agent-Aufgaben sowie über die Software, die zum Ausführen der jeweiligen Aufgabe erforderlich ist:
Build-Agent-Aufgabe |
Erforderliche Software auf dem Build-Agent-Computer |
|---|---|
Erstellen von ASP.NET-Webanwendungsprojekten |
Visual Studio 2010 |
Erstellen von C++-Projekten |
Visual Studio 2010 |
Zuweisen von Tags zu einem Build-Agent
Mit zunehmender Größe des Buildsystems müssen unter Umständen spezialisierte Build-Agents definiert werden. Weisen Sie Build-Agents, die mit speziellen Funktionen ausgestattet oder für einen bestimmten Verwendungszweck vorgesehen sind, mindestens ein Tag zu. Auf diese Weise kann ein Teammitglied beim Erstellen einer Builddefinition, die eine bestimmte Art von Build-Agent erfordert, das Tag in der Builddefinition angeben.
Ein Build-Agent kann mit mehreren Tags versehen werden. So können Sie beispielsweise einen Build-Agent mit den Tags "x86" und "Release" erstellen, um anzugeben, dass der Agent zum Kompilieren der Releasekonfiguration einer 32-Bit-Anwendung konfiguriert ist.
Wenn Sie auf einem Buildcomputer mehrere Build-Agents ausführen, verfügen vermutlich alle über die gleichen Funktionen. Daher empfiehlt es sich in der Regel auch, alle Build-Agents auf diesem Buildcomputer mit den gleichen Tags zu versehen.
Ersetzen von Build-Agent-Funktionen durch Tags
Die folgende Tabelle enthält Beispiele für Tagnamen sowie Build-Agent-Funktionen, für die diese stehen können:
Mögliche Tags für den Build-Agent |
Build-Agent-Funktion(en) |
|---|---|
x86 |
Kompilieren von 32-Bit-Anwendungen |
x64 |
Kompilieren von 64-Bit-Anwendungen |
IIS |
Kompilieren einer ASP.NET-Webanwendung und anschließendes Bereitstellen und Hosten der Anwendung auf dem Buildcomputer, auf dem der Build-Agent ausgeführt wird |
Test, Belastung |
Ein Build-Agent, der auf einem Buildcomputer ausgeführt wird, auf dem Test Professional 2010 zum Ausführen von Auslastungs- und Belastungstests eingerichtet wurde. |
Verwenden von Tags zum Lastenausgleich beim Buildprozess
Mithilfe von Tags können Sie die Lasten bei den Arbeiten zur Buildverarbeitung ausgleichen, die vom Team ausgeführt werden müssen. Angenommen, Sie verfügen über eine Builddefinition zum Überprüfen von Eincheckvorgängen mit der Bezeichnung "Build einchecken". (Weitere Informationen finden Sie unter Definieren eines abgegrenzten Eincheckbuilds zur Überprüfung der Änderungen.) Diese Builddefinition wird häufig ausgeführt, und es kann immer nur eine Instanz davon ausgeführt werden. Also richten Sie einen Buildcomputer mit besonders leistungsfähiger Hardware (beispielsweise mit einem schnellen Multikernprozessor und einer schnellen Festplatte) ein. Anschließend erstellen Sie auf dem Computer einen Build-Agent und weisen ihm das Tag "Einchecken" zu. Sie richten die Builddefinition so ein, dass sie nur von einem Build-Agent mit dem Tag "Einchecken" ausgeführt wird.
Sie verfügen über eine weitere Builddefinition mit dem Namen "Schnellbuild", mit der die Builds eines Projekts, das von einem Team bearbeitet wird, mit höchster Priorität verarbeitet werden. Sie richten einen weiteren Build-Agent ein, der die Anforderungen dieses besonderen Projekts erfüllt. Sie weisen ihm das Tag "Schnell" zu und richten anschließend die Builddefinition so ein, dass sie nur von einem Build-Agent ausgeführt wird, der über dieses Tag verfügt.
So wenden Sie auf einem Clientcomputer ein Tag auf einen Build-Agent an
Klicken Sie im Menü Erstellen auf Buildcontroller verwalten.
Das Dialogfeld Buildcontroller verwalten wird angezeigt.
Klicken Sie auf den Build-Agent, den Sie mit einem Tag versehen möchten, und klicken Sie anschließend auf Eigenschaften.
Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt.
Verwenden Sie zum Anwenden von Tags eine der folgenden Methoden:
Wählen Sie in der Liste mindestens ein Tag aus.
Klicken Sie auf den Link Neues Tag hinzufügen. Geben Sie im Dialogfeld Neues Tag hinzufügen den Namen des anzuwendenden Tags ein.
So wenden Sie auf dem Buildcomputer ein Tag auf einen Build-Agent an
Melden Sie sich an dem Buildcomputer an, auf dem der zu ändernde Build-Agent ausgeführt wird.
Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.
Die Team Foundation-Verwaltungskonsolewird angezeigt.
Erweitern Sie im Strukturbereich den Namen des Servers, und klicken Sie anschließend auf den Knoten Team Foundation-Build.
Klicken Sie direkt unter dem Namen des Build-Agents auf Eigenschaften.
Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt.
Verwenden Sie zum Anwenden von Tags eine der folgenden Methoden:
Wählen Sie in der Liste mindestens ein Tag aus.
Klicken Sie auf den Link Neues Tag hinzufügen. Geben Sie im Dialogfeld Neues Tag hinzufügen den Namen des anzuwendenden Tags ein.
Entfernen eines Build-Agents
Sie können einen Build-Agent sowohl mithilfe eines Clientcomputers als auch direkt auf dem Buildcomputer entfernen, von dem der Build-Agent gehostet wird.
Hinweis Team Foundation-Builddienst wird auf dem Buildcomputer nicht deinstalliert, wenn Sie den Build-Agent entfernen.
So entfernen Sie einen Build-Agent mithilfe eines Clientcomputers
Klicken Sie im Menü Erstellen auf Buildcontroller verwalten.
Das Dialogfeld Buildcontroller verwalten wird angezeigt.
Klicken Sie auf den zu entfernenden Buildcontroller oder Build-Agent und anschließend auf Löschen.
So entfernen Sie einen Build-Agent vom Buildcomputer
Melden Sie sich an dem Buildcomputer an, auf dem der zu ändernde Build-Agent ausgeführt wird.
Klicken Sie auf Start, auf Alle Programme, auf Microsoft Team Foundation Server 2010 und dann auf Team Foundation-Verwaltungskonsole.
Die Team Foundation-Verwaltungskonsolewird angezeigt.
Erweitern Sie im Strukturbereich den Namen des Servers, und klicken Sie dann auf den Knoten Team Foundation Build.
Klicken Sie direkt unter dem Namen des Build-Agents auf Löschen.
Siehe auch
Weitere Ressourcen
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
|---|---|---|
|
Mai 2011 |
Es wurden Informationen zum Ausführen von Tests hinzugefügt. |
Informationsergänzung. |