Definieren eines Builds mithilfe der Upgradevorlage

Mithilfe der Upgradevorlage können Sie ältere Builddefinitionen in Visual Studio Team Foundation Server 2010 weiterhin verwenden. Mit dieser Vorlage können Sie insbesondere die folgenden Arten von Buildobjekten ausführen:

• Builddefinitionen, die mit Visual Studio Team System 2008 Team Foundation Server erstellt wurden

• Buildtypen, die mit Visual Studio 2005 Team Foundation Server erstellt wurden

Wenn Sie ein Upgrade auf Team Foundation Server 2010 ausführen, erstellt das System automatisch für jede ältere Builddefinition und jeden Buildtyp im System eine Upgradevorlagen-Builddefinition.

Wenn Sie mit einer früheren Version von Visual Studio ALM eine Builddefinition oder einen Buildtyp auf einem Server erstellen, auf dem Team Foundation Server 2010 ausgeführt wird, erstellt das System ebenfalls automatisch eine Upgradevorlagen-Builddefinition.

Zum Ändern der meisten Aspekte der älteren Buildobjekte müssen Sie die Datei TFSBuild.proj ändern. Weitere Informationen finden Sie unter Ziele, Aufgaben und Eigenschaften von Team Foundation Build. Sie können jedoch einige Einstellungen im Builddefinitionsobjekt ändern, indem Sie den Knoten Builds in Team Explorer öffnen. Diese Einstellungen werden in diesem Thema erläutert.

Erforderliche Berechtigungen

Zum Ausführen dieser Schritte muss für Sie die Berechtigung Builddefinition bearbeiten auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So ändern Sie eine Upgradevorlagen-Builddefinition

1. Erweitern Sie in Team Explorer das Teamprojekt, in dem Sie den Build definieren möchten, und erweitern Sie dann den Knoten Builds.

2. Klicken Sie mit der rechten Maustaste auf die Builddefinition, die Sie ändern möchten, und klicken Sie dann auf Builddefinition bearbeiten.

3. Öffnen Sie auf der Registerkarte Build-Standardwerte das Menü Buildcontroller, und wählen Sie dann einen Buildcontroller aus.

4. Klicken Sie auf die Registerkarte Prozess.

5. Stellen Sie sicher, dass unter Buildprozessdatei Upgrade-Vorlage angezeigt wird.

6. Erweitern Sie den Knoten Erforderlich.

7. Stellen Sie sicher, dass in Konfigurationsordnerpfad der Pfad des Ordners, der die Datei TFSBuild.proj enthält, ordnungsgemäß angegeben ist.

8. Verwenden Sie die Informationen weiter unten in diesem Thema zum Ausfüllen der Felder, die die Funktionen bereitstellen, die in dieser Builddefinition enthalten sein sollen.

9. Nachdem Sie die erforderlichen Felder auf der Registerkarte Prozess ausgefüllt haben, ändern Sie die Felder auf den Registerkarten Trigger, Arbeitsbereich, Build-Standardwerte und Beibehaltungsrichtlinie.

   Weitere Informationen finden Sie unter Erstellen einer einfachen Builddefinition.

In diesem Thema

• Informationen zu den Buildprozessparametern für die Upgradevorlage

• Angeben der Ausführlichkeit des Protokolls

• Angeben, von welchen Build-Agents der Build verarbeitet wird

• Angeben von Build-Agent-Zeitlimits

• Angeben von erweiterten Buildprozessparametern

Informationen zu den Buildprozessparametern für die Upgradevorlage

In diesem Thema wird erläutert, wie ein Build mithilfe der Buildprozessparameter für Builds geändert wird, die auf der Upgradevorlage basieren. Diese Informationen gelten für Visual Studio Application Lifecycle Management (ALM), solange die folgenden Bedingungen erfüllt sind:

• Sie arbeiten in einem Teamprojekt, das aus einer der beiden Prozessvorlagen in Visual Studio ALM erstellt wurde: MSF for Agile Software Development, Version 5.0, oder MSF for CMMI Process Improvement, Version 5.0.

• Die Upgradevorlage wurde von keinem Mitglied des Teams entfernt oder angepasst.

Angeben der Ausführlichkeit des Protokolls

Um die Ausführlichkeit des im Buildergebnisfenster angezeigten Protokolls anzugeben, erweitern Sie den Knoten Standard, und wählen Sie dann in der Liste Protokollierungsausführlichkeit einen Wert aus. In der folgenden Tabelle werden die Werte für die Protokollierungsausführlichkeit und ihre entsprechenden Auswirkungen aufgeführt.

Wert	Buildfehler	Buildwarnungen	Buildmeldungen Build Meldungen	Buildmeldungen Build Meldungen	Buildmeldungen Build Meldungen	Workflowaktivitätseigenschaften (Eingaben und Ausgaben)
Minimal	J	N	N	N	N	N
Normal	J	J	J	N	N	N
Detailed	J	J	J	J	N	N
Diagnose	J	J	J	J	J	J

Der von Ihnen angegebene Wert für die Protokollierungsausführlichkeit wirkt sich auch auf die Ausführlichkeit von Meldungen aus, die aus MSBuild stammen. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz.

Weitere Informationen zu Buildberichten finden Sie unter Anzeigen des Fensters "Buildergebnisse".

Angeben, von welchen Build-Agents der Build verarbeitet wird

Um anzugeben, welche Build-Agents zum Verarbeiten des Builds verwendet werden, erweitern Sie den Knoten Erweitert, erweitern Sie den Knoten Agent-Einstellungen, und füllen Sie dann eines der beiden folgenden Felder aus:

• Namensfilter: Sie können die Build-Agents, mit denen die Builddefinition verarbeitet wird, filtern, indem Sie in diesem Feld den Namen des Agents eingeben. Sie können auch mit den Platzhalterzeichen * und ? einen Satz von Namen angeben. Beispielsweise können Sie mit CI* alle Agents angeben, deren Name mit den Zeichen CI beginnt. Diesem Kriterium entsprechen z. B. die Agents CI, CI1 und CI_Agent2.

• Tagfilter: Geben Sie ein oder mehrere Tags an, um sicherzustellen, dass der Build nur von Build-Agents mit übereinstimmenden Tags ausgeführt wird. Beispiel: Sie richten einen Build-Agent auf einem Buildcomputer ein, der die abgegrenzten Eincheckbuilds verarbeiten soll. Sie wenden auf diesen Build-Agent das Tag Abgegrenzt an. Schließlich wenden Sie das Tag Abgegrenzt auf die Builddefinition an, damit der Build nur von dem Agent verarbeitet wird, der ebenfalls mit dem Tag Abgegrenzt markiert ist. Klicken Sie zum Angeben von Tags auf die Schaltfläche mit den Auslassungspunkten (...).

  Tipp

  Die Gruppe der zum Verarbeiten des Builds verfügbaren Build-Agents wird vom Buildcontroller bestimmt, den Sie für die Builddefinition angegeben haben. Um den Buildcontroller zu ändern, klicken Sie auf die Registerkarte Build-Standardwerte, öffnen Sie das Menü Buildcontroller, und wählen Sie dann in diesem Menü einen Buildcontroller aus.

Angeben von Build-Agent-Zeitlimits

Um Zeitlimits anzugeben, erweitern Sie den Knoten Erweitert, erweitern Sie den Knoten Agent-Einstellungen, und geben Sie dann die folgenden Parameter an.

Zweck	Festzulegender Parameter	Anleitung
Angeben der maximal zulässigen Zeitspanne für die Verarbeitung des Builds durch den Build-Agent	Maximale Ausführzeit	Geben Sie einen Zeitspannenwert im Format hh:mm:ss ein. Beispielsweise schlägt der Build mit einem Timeoutfehler fehl, wenn Sie den Wert 04:30:15 angeben und die Verarbeitung durch den Build-Agent nach 4 Stunden, 30 Minuten und 15 Sekunden nicht abgeschlossen ist. Geben Sie den Wert 00:00:00 an, wenn Sie eine unbegrenzte Zeitspanne für die Verarbeitung des Builds durch den Build-Agent festlegen möchten.
Angeben der maximal zulässigen Zeitspanne zum Zuweisen der Buildanforderung an einen Build-Agent	Maximale Wartezeit	Geben Sie einen Zeitspannenwert im Format hh:mm:ss ein. Beispielsweise schlägt der Build mit einem Timeoutfehler fehl, wenn Sie den Wert 01:30:45 angeben und der Build nach 1 Stunde, 30 Minuten und 45 Sekunden noch keinem Build-Agent zugewiesen wurde. Geben Sie den Wert 00:00:00 an, wenn Sie für den Buildcontroller eine unbegrenzte Zeitspanne zum Suchen eines Build-Agents für die Verarbeitung der Builddefinition festlegen möchten.

Angeben von erweiterten Buildprozessparametern

Um weniger typische Szenarios erfolgreich abzuschließen, müssen Sie die Buildprozessparameter im Knoten Erweitert ändern.

Zweck	Festzulegender Parameter	Anleitung
Angeben des Unterverzeichnisses, in dem sich die Binärdateien nach ihrer Erstellung befinden	Unterverzeichnis für Binärdateien	Wenn Sie kein Unterverzeichnis angeben, verwendet das System ein Unterverzeichnis mit dem Namen Binaries.
Verwenden der auf dem lokalen Computer vorhandenen Buildtypdefinition	Buildtyp nicht herunterladen	Legen Sie dieses Flag auf True fest, wenn Sie die Buildtypdefinition auf dem lokalen Computer verwenden möchten, statt die Definition aus Team Foundation Server herunterzuladen. Der verwendete lokale Pfad ist der lokale Arbeitsbereich für den Buildtyp. Dieser Parameter ist in der Regel vorübergehend auf True festgelegt, damit Sie die Datei TFSBuild.proj debuggen können.
Generieren von Fehler- und Warnungsprotokolldateien für einzelne Projekte	Protokolldatei pro Projekt	Legen Sie diesen Wert auf True fest, um Fehler- und Warnungsprotokolldateien für einzelne Projekte statt für einzelne Kombinationen von Plattform und Konfiguration zu generieren.
Angeben von Befehlszeilenargumenten, die an MSBuild übergeben werden sollen	MSBuild-Argumente	Wenn der Buildvorgang erfordert, dass Sie Argumente an MSBuild weiterleiten, geben Sie diese im Parameter MSBuild-Argumente ein. Weitere Informationen finden Sie unter MSBuild-Befehlszeilenreferenz.
Angeben der Bitanzahl der zum Verarbeiten des Builds verwendeten Version von MSBuild	MSBuild-Plattform	Geben Sie einen der folgenden Werte an: Geben Sie Auto an, wenn MSBuild mit der CPU-Bitanzahl der auf dem Build-Agent installierten Instanz von Team Foundation-Builddienst ausgeführt werden soll. Geben Sie X86 an, wenn der Build immer mit der 32-Bit-Version von MSBuild verarbeitet werden soll. Da Visual Studio 2010 als 32-Bit-Anwendung ausgeführt wird, treten möglicherweise Probleme auf, wenn der Build von einem Build-Agent verarbeitet wird, der die 64-Bit-Version von Team Foundation-Builddienst ausführt. Durch Festlegen von x86 wird diese Art von Problem meist gelöst. Geben Sie X64 an, wenn der Build immer mit der 64-Bit-Version von MSBuild verarbeitet werden soll. Hinweis Wenn Sie diesen Wert angeben, stellen Sie sicher (z. B. mit einem Tag, wie weiter oben in diesem Thema erläutert), dass der Build von einem Build-Agent verarbeitet wird, dessen Host ein 64-Bit-Buildcomputer ist.Andernfalls schlägt der Build fehl.
Festlegen, dass MSBuild Dateien im Konfigurationsordnerpfad rekursiv abruft und verwendet	Rekursionstyp	Geben Sie einen der folgenden Werte an: Eine Ebene, wenn der in Konfigurationsordnerpfad angegebene Ordner Dateien enthält, die von MSBuild verarbeitet werden sollen. Voll, wenn der in Konfigurationsordnerpfad angegebene Ordner oder Unterverzeichnisse dieses Ordners Dateien enthalten, die von MSBuild verarbeitet werden sollen.
Angeben des Unterverzeichnisses, das zum Zuordnen von Arbeitsbereich und Build verwendet wird	Unterverzeichnis für Quellen	Legen Sie diesen Wert auf das entsprechende Quellenunterverzeichnis für die Build-Agents fest, die diesen Buildcomputer verwenden. Wenn Sie kein Unterverzeichnis angeben, verwendet das System ein Unterverzeichnis mit dem Namen Sources.
Angeben des Unterverzeichnisses, das zum Speichern der Ergebnisse der Tests verwendet wird	Unterverzeichnis für Testergebnisse	Legen Sie diesen Wert auf das entsprechende Testergebnis-Unterverzeichnis für die Build-Agents fest, die diesen Buildcomputer verwenden. Wenn Sie kein Unterverzeichnis angeben, verwendet das System ein Unterverzeichnis mit dem Namen TestResults.