Erstellen einer einfachen Builddefinition

Wenn Sie ein Buildsystem (wie unter Konfigurieren des Buildsystems beschrieben) platziert haben, sind fast alle Voraussetzungen erfüllt, um den Code mit Team Foundation Build kompilieren sowie die Tests und zahlreiche andere wichtige Funktionen ausführen zu können. Im nächsten Schritt erstellen Sie eine Builddefinition. Eine Builddefinition enthält Anweisungen zu den zu kompilierenden Codeprojekten, den zusätzlich auszuführenden Vorgängen und zu deren Ausführung selbst.

Erforderliche Berechtigungen

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

So erstellen Sie eine Builddefinition

  1. Klicken Sie in Team Explorer auf das Projekt, für das Sie eine neue Builddefinition erstellen möchten.

  2. Klicken Sie im Menü Erstellen auf Neue Builddefinition.

    Das Fenster Neue Builddefinition wird mit der Registerkarte Allgemein angezeigt.

  3. Geben Sie im Feld Builddefinitionsname den Namen an, der der Builddefinition zugeordnet werden soll.

  4. Fügen Sie im Textfeld Beschreibung eine entsprechende Beschreibung hinzu.

    Diese Beschreibung enthält für Teammitglieder weitere Informationen zum manuellen Stellen eines Builds in die Warteschlange (wie unter Stellen eines Builds in die Warteschlange beschrieben).

  5. Klicken Sie auf die Registerkarte Build-Standardwerte.

  6. Lassen Sie das Kontrollkästchen Dieser Build kopiert Ausgabedateien in einen Ablageordner aktiviert.

    Tipp

    Die Builds schlagen fehl, wenn Sie dieses Kontrollkästchen deaktivieren und eine Buildvorlage verwenden, die eine Ausgabe erzeugt.

  7. Geben Sie im Feld Buildausgabe in den folgenden Ablageordner kopieren den UNC-Dateipfad des Ordners ein, in dem Sie das Buildsystem Binärdateien und Protokolldateien speichern soll.

    Wichtig

    Sie müssen einen Ordner angeben, der für die Verwendung als Ablageordner vorbereitet wurde. Weitere Informationen finden Sie unter Einrichten von Ablageordnern.

  8. Wenn in der Liste Buildcontroller mehrere Buildcontroller angezeigt werden, klicken Sie auf den Buildcontroller, der vom Buildsystem zum Verarbeiten dieser Builddefinition verwendet werden soll.

  9. Klicken Sie auf die Registerkarte Trigger, und geben Sie das Ereignis an, das zum Ausführen dieser Builddefinition führen soll. Weitere Informationen finden Sie unter Angeben der Buildtrigger und Gründe.

  10. Klicken Sie auf die Registerkarte Prozess, und geben Sie Details zu den von diesem Build ausgeführten Funktionen sowie zur Art der Ausführung an:

    • Zum schnellen und einfachen Definieren eines Builds klicken Sie in der Liste Buildprozessdatei auf Standardvorlage. Überprüfen und ändern Sie nach Bedarf die Werte der Buildprozessparameter. Weitere Informationen, z. B. Erklärungen der Buildprozessparameter und deren Verwendung, finden Sie unter Definieren eines Builds mithilfe der Standardvorlage.

    • Wenn das Team einen von MSBuild gesteuerten Buildprozess verwenden muss, klicken Sie in der Liste Buildprozessdatei auf Upgradevorlage. Überprüfen und ändern Sie nach Bedarf die Werte der Buildprozessparameter. Weitere Informationen, z. B. Erklärungen der Buildprozessparameter und deren Verwendung, finden Sie unter Definieren eines Builds mithilfe der Upgradevorlage.

    • Wenn das Team eine benutzerdefinierte Vorlage definiert hat, die Sie verwenden möchten, klicken Sie in der Liste Buildprozessdatei auf diese. Überprüfen und ändern Sie nach Bedarf die Werte der Buildprozessparameter. Weitere Informationen finden Sie unter Erstellen und Verwenden einer benutzerdefinierten Buildprozessvorlage.

  11. Um sicherzustellen, dass die für den Buildprozess benötigten Dateien in den Build-Agent heruntergeladen werden, klicken Sie auf die Registerkarte Arbeitsbereich, und passen Sie die Einstellungen nach Bedarf an. Weitere Informationen finden Sie unter Löschen eines abgeschlossenen Builds.

  12. Klicken Sie auf die Registerkarte Beibehaltungsrichtlinie.

    Zwei Sätze von Beibehaltungsrichtlinien werden in der Liste Gewünschte Beibehaltung der Builds angezeigt und können den Anforderungen des Teams entsprechend geändert werden:

    • Durch die Richtliniengruppe Mit Trigger und manuell werden die vom System beibehaltenen Elemente der Builds eingeschränkt, die manuell oder durch einen automatischen Trigger in die Warteschlange gestellt wurden.

    • Durch die Richtliniengruppe Privat werden die vom System beibehaltenen Elemente der Builds eingeschränkt, die manuell oder aus dem Quellcode in einem Shelveset in die Warteschlange gestellt wurden (wie unter Stellen eines Builds in die Warteschlange beschrieben).

    Wenn Sie eine Beibehaltungsrichtlinie für Builds ändern möchten, die mit Beendet, Fehler, Teilweise erfolgreich oder Erfolgreich abgeschlossen wurden, führen Sie mindestens einen der beiden folgenden Schritte aus:

    • Klicken Sie in der Spalte Beibehaltungsrichtlinie auf den Wert, und klicken Sie dann auf eine der folgenden Optionen: Alle beibehalten, Nur letzte beibehalten, Letzte 2 beibehalten, Letzte 5 beibehalten, Letzte 7 beibehalten, Letzte 10 beibehalten oder Geben Sie die beizubehaltende Anzahl an.

    • Klicken Sie in der Spalte Zu löschende Elemente auf den Wert, und klicken Sie auf einen Wert. Weitere Informationen über diesen Werten finden Sie unter Arbeiten mit Buildarbeitsbereichen.

  13. Wenn Sie die Arbeit an der Builddefinition beenden, öffnen Sie das Menü Datei, und klicken auf <Name der Builddefinition> speichern.

    Die erstellte Builddefinition wird in Team Explorer im Ordner Builds angezeigt. Zum Anzeigen oder Ändern der Einstellungen für die Builddefinition klicken Sie mit der rechten Maustaste auf diese, und klicken Sie dann auf Builddefinition bearbeiten.

Siehe auch

Aufgaben

Löschen einer Builddefinition

Weitere Ressourcen

Definieren des Buildprozesses