Exemplarische Vorgehensweise: Erstellen einer Builddefinition in Team Foundation Build

Artikel
08/20/2008

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird erläutert, wie eine Builddefinition für Team Foundation Build konfiguriert wird. Für diese exemplarische Vorgehensweise sind Grundkenntnisse von Team Foundation Build eine wichtige Voraussetzung. Weitere Informationen hierzu finden Sie unter Verwalten von Builds mit Team Foundation Build.

In dieser exemplarischen Vorgehensweise gehen Sie schrittweise vor und konfigurieren im Dialogfeld Builddefinition eine Builddefinition. Außerdem richten Sie die Berechtigungen ein, die für den Build-Agenten und die Benutzer erforderlich sind, die die neu erstellten Builddefinitionen ausführen. Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

Erstellen einer neuen Builddefinition.
Auswählen der zu erstellenden Projektmappen.
Auswählen eines Build-Agenten und eines Ablagespeicherortes.
Auswählen der Buildschritte.
Auswählen einer Konfiguration und der Plattformen für den Build.
Einrichten von Berechtigungen auf dem Build-Agenten.
Einrichten der Berechtigungen für angegebene Benutzer, damit diese die neu erstellte Builddefinition ausführen können.

Vorbereitungsmaßnahmen

Visual Studio Team System Team Foundation Server.
Eine Verbindung mit Team Foundation Server und mindestens ein vorhandenes Teamprojekt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt und unter Gewusst wie: Erstellen eines Teamprojekts.
Ein Arbeitsbereich auf dem Quellcodeverwaltungsserver, der mindestens eine zu erstellende Projektmappe enthält. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen eines zugeordneten Arbeitsbereichs.

Erforderliche Berechtigungen

Zum Abschließen dieser exemplarischen Vorgehensweise muss die Build verwalten-Berechtigung auf Zulassen festgelegt sein. Für das Dienstkonto auf Anwendungsebene und das Team Foundation Build-Dienstkonto werden zudem Lese-/Schreibberechtigungen für den Ablagespeicherort des Builds benötigt. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So erstellen Sie eine neue Builddefinition

Wählen Sie in Team Explorer das Projekt aus, für das Sie eine neue Builddefinition erstellen möchten.
Klicken Sie im Menü Erstellen auf Neue Builddefinition.

Das Dialogfeld Builddefinition wird mit der ausgewählten Registerkarte Allgemein angezeigt.

Tipp:

Auf den Registerkarten, neben deren Namen ein Warnsymbol angezeigt wird, müssen Daten eingegeben werden.
Geben Sie im Textfeld Builddefinitionsname den Namen an, der der Builddefinition zugeordnet werden soll.

Der Name, den Sie eingeben, muss ein eindeutiger und gültiger Windows-Dateiname sein.
Fügen Sie im Textfeld Beschreibung eine entsprechende Beschreibung hinzu.

Diese Beschreibung wird im Dialogfeld Build <Teamprojektname> zu Warteschlange hinzufügen angezeigt. Weitere Informationen finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.
Klicken Sie auf die Registerkarte Arbeitsbereich.

Die Tabelle Arbeitsordner enthält standardmäßig den Quellcodeverwaltungsordner für das Teamprojekt, für das Sie die neuen Builddefinitionen erstellen. Auf dem Build-Agenten wird ein lokaler Ordner erstellt, der die Quellcodeverwaltungshierarchie spiegelt. In der Spalte Lokaler Ordner wird der lokale Ordner auf dem Build-Agenten aufgelistet. Alle Arbeitsbereichspfade im Build-Agent werden relativ zum angezeigten Standardstammverzeichnis zugeordnet.
Um einen vorhandenen Arbeitsbereich in die Liste der Arbeitsordner zu kopieren, klicken Sie auf die Schaltfläche Vorhandenen Arbeitsbereich kopieren, um das Dialogfeld Arbeitsbereich für das Kopieren auswählen zu öffnen.

Der ausgewählte Arbeitsbereich wird auf das allgemeine Stammverzeichnis auf dem Build-Agenten ausgerichtet.

Sie können auch in Quellcodeverwaltungsordner in eine leere Tabellenzelle und dann auf die Schaltfläche mit den Auslassungspunkten (…) klicken, um zu einem Quellcodeverwaltungsordner zu wechseln, der als Arbeitsordner hinzugefügt werden soll. Der von Ihnen ausgewählte Quellverwaltungsordner wird ebenfalls auf das allgemeine Stammverzeichnis auf dem Build-Agent normalisiert.
Klicken Sie auf die Registerkarte Projektdatei. Im Bereich Projektdatei können Sie entweder zu einer vorhandenen TFSBuild.proj-Projektdatei wechseln oder den MSBuild-Projektdateierstellungs-Assistenten aufrufen, um eine neue TFSBuild.proj-Datei zu erstellen.

Tipp:
Auf den Registerkarten, neben deren Namen ein Warnsymbol angezeigt wird, müssen Daten eingegeben werden.

Um zu einer vorhandenen TFSBuild.proj-Datei zu wechseln, klicken Sie auf Durchsuchen. Wählen Sie im Dialogfeld Ordner suchen aus dem Ordner TeamBuildTypes eine vorhandene Builddefinition aus, und klicken Sie dann auf OK.

Die Datei TFSBuild.proj wird jetzt von der vorhandenen und der neuen Builddefinition gemeinsam verwendet.

Wenn eine TFSBuild.proj-Datei gefunden wurde, wird im Bereich Projektdatei der Text MSBuild-Projektdatei gefunden: TFSBuild.proj angezeigt. Wenn keine Projektdatei gefunden wurde, werden im Bereich Projektdatei ein Warntext und der Hinweis angezeigt, eine neue MSBuild-Projektdatei zu erstellen.

Wichtiger Hinweis:
Mit allen Änderungen, die Sie an einer gemeinsam genutzten TFSBuild.proj-Datei vornehmen, passen Sie alle Builddefinitionen an, denen die Datei zugeordnet ist. Weitere Informationen finden Sie unter Anpassen von Team Foundation Build.

Um eine neue Projektdatei für die Builddefinition zu erstellen, klicken Sie auf Erstellen.

Der MSBuild-Projektdateierstellungs-Assistent wird angezeigt.

Wählen Sie auf der Seite Zu erstellende Projektmappen auswählen und sortieren die zu erstellenden Projektmappen aus. Um die Projektmappen zu sortieren, wählen Sie eine einzelne Projektmappe aus und verwenden die Pfeiltasten rechts neben der Liste, um ihre Anordnung in der Buildreihenfolge zu ändern.

Vorsicht:
Beachten Sie die Abhängigkeiten zwischen den Projektmappen, wenn Sie die Reihenfolge bestimmen, in der sie erstellt werden. Falls Projektmappe2 z. B. von Projektmappe1 abhängig ist, legen Sie fest, dass Projektmappe1 vor Projektmappe2 erstellt wird.

Klicken Sie auf Weiter.

Die Seite Zu erstellende Konfigurationen auswählen wird angezeigt.
Wählen Sie in der Tabelle unter Welche Konfigurationen möchten Sie erstellen die gewünschte Konfiguration und die Plattformen aus, die in die Builddefinitionen aufgenommen werden sollen. Die Buildkonfiguration gibt die Konfiguration und die Plattform an (z. B. Release und AnyCPU).

Hinweis:

Wenn Sie eine Builddefinition für Webprojekte erstellen, wählen Sie Gemischte Plattformen aus.
Klicken Sie auf Weiter.

Die Seite Buildoptionen auswählen wird angezeigt.

Hinweis:
Wenn Sie eine Builddefinition für Webprojekte erstellen, wählen Sie Gemischte Plattformen aus.

Geben Sie die gewünschten Buildoptionen an, indem Sie die Kontrollkästchen Test ausführen(z.B. BVTs usw. ausführen) und Codeanalyse ausführen aktivieren. Wenn das Kontrollkästchen Test ausführen (z.B. BVTs usw. ausführen) aktiviert ist, können Sie mithilfe der Dropdownoptionen die entsprechende Testmetadatendatei und die Auszuführende Testliste angeben.

Weitere Informationen finden Sie unter Verwenden von Testlisten und unter Verfassen von qualitativ hochwertigem Quellcode.

Wichtiger Hinweis:
Zum Ausführen von Tests muss Test Edition auf dem Build-Agenten installiert sein. Um die Codeanalyse auszuführen, muss Development Edition auf dem Build-Agenten installiert sein.

Klicken Sie auf Fertig stellen.

Der Bereich Projektdatei des Dialogfelds Builddefinition wird angezeigt. Die Datei TFSBuild.proj, die Sie erstellt haben, wird unter $<Team Project>\TeamBuild Types\<Build Type Name>\TFSBuild.proj in der Quellcodeverwaltung gespeichert.

Klicken Sie auf die Registerkarte Beibehaltungsrichtlinie.
1. In der Liste Geben Sie an, wie Builds beibehalten werden sollen können Sie die Beibehaltungsrichtlinie für fehlgeschlagene, angehaltene, teilweise erfolgreiche oder komplett erfolgreiche Builds auswählen.
2. Wählen Sie in der Dropdownliste eine Beibehaltungsrichtlinie aus.
  
  Wenn Sie <Geben Sie die beizubehaltende Anzahl an> auswählen, wird das Dialogfeld Buildanzahl angezeigt.
3. Geben Sie im Textfeld Anzahl beizubehaltender Builds an, wie viele Builds Sie für die angegebene Buildausgabe beibehalten möchten.

Klicken Sie auf die Registerkarte Build-Standardwerte.

Im Bereich Build-Standardwerte können Sie einen vorhandenen Build-Agent aus der Dropdownliste Build-Agent auswählen.
Wenn kein Build-Agent vorhanden ist oder Sie einen neuen erstellen möchten, klicken Sie auf Neu.

Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt.
Geben Sie in den Textfeldern Anzeigename, Beschreibung und Computername Daten ein, und klicken Sie auf OK.

Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen und Verwalten von Build-Agents.

Geben Sie im Textfeld Builds werden auf der folgenden Freigabe bereitgestellt (z. B. \\Server\Freigabe) den UNC-Speicherort (\\Server\Freigabe) ein. Nach Abschluss des Builds befinden sich die erstellten Binärdateien und Protokolldateien in diesem Ordner.

Wichtiger Hinweis:
Bevor Sie diesen Schritt abschließen, müssen Sie zuerst einen öffentlichen Ordner auf dem Build-Agent-Computer erstellt haben, auf dem das TFSService-Konto umfassende Rechte besitzt. Weitere Informationen über Team Foundation-Dienstkonten finden Sie unter Gewusst wie: Anzeigen von Team Foundation Server-Diensten.

Hinweis:
Jeder generierte Build wird in einem separaten Verzeichnis abgelegt. Sie müssen sicherstellen, dass das Konto, mit dem der Buildcomputer konfiguriert wird, über Schreibzugriff auf diesen UNC-Speicherort verfügt.

Klicken Sie auf die Registerkarte Trigger.
1. Wählen Sie im Bereich Trigger die Option Eincheckvorgänge führen nicht zu einem neuen Build aus, um nur bei Bedarf Builds zu erstellen.
2. Wählen Sie Build für jeden Eincheckvorgang (mehr Builds) aus, um fortlaufend immer dann Builds zu erstellen, wenn Änderungen in die Dateien eingecheckt werden, die durch Ihre Builddefinition erstellt werden.
3. Wählen Sie Eincheckvorgänge sammeln, bis der vorherige Build abgeschlossen ist (weniger Builds) aus, um rollende Builds zu erstellen.
  
  Wenn Sie das Kontrollkästchen Eincheckvorgänge sammeln, bis der vorherige Build abgeschlossen ist (weniger Builds) aktiviert haben, können Sie angeben, wie oft Builds stattfinden. Aktivieren Sie dazu das Kontrollkästchen Nicht häufiger erstellen als, und geben Sie im Textfeld Minuten eine Zahl ein. Der gültige Bereich für das Textfeld Minuten ist 0 bis 2147483647 (Int32 MaxValue).
4. Wählen Sie Build jede Woche an folgenden Tagen aus, um geplante Builds zu erstellen. Wählen Sie mit den Kontrollkästchen für die einzelnen Wochentage die Tage aus, an denen Sie Builds erstellen möchten. Geben Sie im Textfeld Build zu Warteschlange des Standard-Build-Agents hinzufügen um die Buildzeit ein.
  
  Hinweis:
  
  Geplante Builds finden nicht statt, wenn seit dem vorherigen Build keine Änderungen eingecheckt wurden.
Klicken Sie auf OK, um die Builddefinition zu erstellen, sobald Sie alle erforderlichen Informationen eingegeben haben.

Die erstellte Builddefinition wird im Ordner Builds in Team Explorer angezeigt.

Hinweis:
Geplante Builds finden nicht statt, wenn seit dem vorherigen Build keine Änderungen eingecheckt wurden.

Um die Informationen zu prüfen, die auf dem Server für Ihre Builddefinition gespeichert sind, klicken Sie in Team Explorer mit der rechten Maustaste darauf, und klicken Sie auf Builddefinition bearbeiten.

Das Dialogfeld Builddefinition wird mit den von Ihnen eingegebenen Informationen angezeigt. Sie haben auch die Möglichkeit, die eingegebenen Informationen zu ändern. Weitere Informationen hierzu finden Sie unter Gewusst wie: Bearbeiten einer Builddefinition.

Wichtiger Hinweis:
Wenn Ihre Builddefinition und ein anderer Build eine TFSBuild.proj-Datei gemeinsam nutzen, werden Ihre Builddefinition und die zugehörigen Dateien nicht im Quellcodeverwaltungs-Explorer im Standardordner TeamBuildTypes angezeigt. Nur die ursprüngliche Builddefinition wird aufgelistet. Sie können die Datei TFSBuild.proj auch an einem anderen Speicherort speichern.

So richten Sie Buildberechtigungen ein

Wenden Sie sich an den Systemadministrator für den zuvor ausgewählten Build-Agenten, und ermitteln Sie den Namen des Kontos, unter dem der Visual Studio Team Foundation Build-Dienst ausgeführt wird.
Wählen Sie im Menü Team die Option Teamprojekteinstellungen und dann Gruppenmitgliedschaften aus.

Das Dialogfeld Projektgruppen wird angezeigt.
Suchen Sie in Projektgruppen unter der Auflistung Benutzer und Gruppen die Gruppe namens Builddienste, und klicken Sie auf Eigenschaften.

Das Dialogfeld Team Foundation Server - Gruppeneigenschaften wird angezeigt.
Wählen Sie die Registerkarte Mitglieder aus.

Wenn das im vorangegangenen Schritt ermittelte Konto in der Mitgliederliste vorhanden ist, kann der ausgewählte Buildcomputer die Builddefinition erstellen. Führen Sie andernfalls die folgenden Schritte aus:
Wählen Sie im Abschnitt Mitglied hinzufügen die Option Windows-Benutzer oder -Gruppe aus, und klicken Sie auf Hinzufügen.

Das Dialogfeld Benutzer oder Gruppen auswählen wird angezeigt.

Geben Sie im Dialogfeld Benutzer oder Gruppen auswählen das Konto ein, das dem Visual Studio Team Foundation Build-Dienst auf dem für diese Builddefinition verwendeten Build-Computer zugeordnet ist.

Hinweis:
Wenn diese Builddefinition auf mehreren Build-Agenten erstellt wird, müssen alle Visual Studio Team Foundation Build-Dienstkonten als Mitglieder der Gruppe 'Build Services' dieses Projekts hinzugefügt werden.

Konfigurieren Sie die Benutzer, die die Builddefinitionen ausführen sollen, indem Sie diesen die Berechtigung zum Starten/Fortsetzen eines Builds gewähren.