Erstellen einer Builddefinition

  • Artikel

Wenn Sie ein Buildsystem (wie unter Setting up and Managing a Build System 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

Sie müssen den Builddefinition bearbeiten Berechtigungssatz zu Zulassen haben.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So erstellen Sie eine Builddefinition

  1. In Team Explorer:

    1. Wenn Sie nicht bereits über eine Verbindung mit dem Teamprojekt verfügen, in dem Sie arbeiten möchten, stellen Sie eine Verbindung mit dem Teamprojekt her.

    2. Wählen Sie Symbol "Startseite"Startseite und dann die Option Symbol "Builds"Builds aus.

    3. Klicken Sie auf der Seite Builds auf Neue Builddefinition.

    Das Fenster "Neue Builddefinition" wird angezeigt.

  2. Gehen Sie auf der Registerkarte Allgemein wie folgt vor:

  3. Wenn der Buildprozess noch nicht für die Verwendung durch das Team bereit ist, können Sie auf der Registerkarte Allgemein unter Warteschlangenverarbeitung die Standardeinstellung von Aktiviert in folgenden Wert ändern:

    • Angehalten: Bei dieser Einstellung können neue Builds von Triggern oder Benutzern in die Warteschlange gestellt werden, aber diese Builds verbleiben im angehaltenen Zustand.

    • Deaktiviert: Es wird verhindert, dass neue Builds von Triggern oder Benutzern in die Warteschlange gestellt werden.

  4. Geben Sie auf der Registerkarte Trigger das Ereignis an, über das diese Builddefinition ausgeführt werden soll.Weitere Informationen finden Sie unter Angeben der Buildtrigger und Gründe.

  5. Geben Sie auf der Registerkarte Arbeitsbereich in der Tabelle Arbeitsordner den Ordner für die Versionskontrolle an, in dem die für den Buildprozess erforderlichen Dateien enthalten sind.

    TippTipp

    Um sicherzustellen, dass der Buildprozess ordnungsgemäß funktioniert, und um die Leistung zu verbessern, sollten Sie alle Ordner einbeziehen, in denen die für den Buildprozess erforderlichen Dateien enthalten sind (und nur diese Dateien).Weitere Informationen zum Angeben dieser Ordner finden Sie unter Arbeiten mit Buildarbeitsbereichen.

  6. Klicken Sie auf der Registerkarte Build-Standardwerte wenn mehrere Buildcontroller in der Liste Buildcontroller angezeigt wird, wählen Sie Buildcontroller aus, dass Sie das Buildsystem verwenden soll, um diese Builddefinition verarbeiten.

    Wenn die Teamprojektsammlung auf Team Foundation-Dienst gehostet wird und die Anforderungen des Teams durch einen einzelnen Standardbuild-agenten erfüllt werden können, wählen Sie Gehosteter Buildcontroller.Siehe Verwenden Sie den gehosteten Buildcontroller in einer Teamprojektsammlung, die auf Team Foundation-Dienst gehostet wird

  7. Wählen Sie auf der Registerkarte Build-Standardwerte eine der folgenden Optionen unter Stagingort aus. Damit geben Sie an, wie während des Buildprozesses Ausgabedateien wie kompilierte Binärdateien und Protokolldateien erstellt und gespeichert werden sollen:

    • Von diesem Build werden keine Ausgabedateien in einen Ablageordner kopiert: Wählen Sie diese Option aus, wenn Sie keine Ausgabedateien benötigen.

    • Kopieren der Buildausgabe in den folgenden Ablageordner: Wählen Sie diese Option aus, wenn Sie Ausgabedateien in einen Ablageordner auf einem Dateifreigabeserver kopieren möchten.Geben Sie im Feld den UNC-Dateipfad des Ordners ein, in dem das Buildsystem die Ausgabedateien speichern soll.Sie müssen einen Ordner angeben, der für die Verwendung als Ablageordner vorbereitet wurde.Weitere Informationen finden Sie unter Einrichten von Ablageordnern.

    • Kopieren der Buildausgabe in den folgenden Quellcodeverwaltungsordner: Wählen Sie diese Option aus, wenn Sie Ausgabedateien in einen Ablageordner der Versionskontrolle kopieren möchten.Geben Sie im Feld den Pfad zu dem Ordner ein (oder wählen Sie … aus, um auf den Ordner zuzugreifen), in dem das Buildsystem die Ausgabedateien speichern soll.Gehen Sie beim Angeben dieses Ordners mit Bedacht vor, da hierfür Einschränkungen gelten.Weitere Informationen finden Sie unter Einrichten von Ablageordnern.

  8. Geben Sie auf der Registerkarte Prozess die Details zu den von diesem Build ausgeführten Funktionen sowie zur Art der Ausführung an:

    • Um einen Build schnell und einfach zu definieren, wählen Sie Details anzeigen und dann in der Liste Buildprozessdatei die Option Standardvorlage aus.Überprüfen und ändern Sie nach Bedarf die Werte der Buildprozessparameter.Weitere Informationen Buildprozessparameter wie Erklärungen und deren Verwendung, finden Sie unter Definieren eines auf der Standardvorlage basierenden Buildprozesses verwendet.

    • Wenn Ihr Team eine benutzerdefinierte Vorlage definiert hat, die Sie verwenden möchten, wählen Sie Details anzeigen aus. Wählen Sie anschließend in der Liste Buildprozessdatei die Vorlage aus.Überprüfen und ändern Sie nach Bedarf die Werte der Buildprozessparameter.Alternativ dazu können Sie einen eigenen benutzerdefinierten Buildprozess erstellen.Weitere Informationen finden Sie unter Erstellen und Verwenden einer benutzerdefinierten Buildprozessvorlage.

  9. Auf der Registerkarte Beibehaltungsrichtlinie können Sie angeben, wie viele abgeschlossene Builds Sie beibehalten möchten.In der Liste Gewünschte Beibehaltung der Builds können Sie zwei Sätze von Beibehaltungsrichtlinien ändern, um die Anforderungen des Teams zu erfüllen:

    • 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:

    • Wählen Sie in der Spalte Beibehaltungsrichtlinie den Wert aus, 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.

    • Wählen Sie den Wert in der Spalte Zu löschende Elemente aus, und wählen Sie einen Wert aus.Weitere Informationen über diesen Werten finden Sie unter Löschen eines abgeschlossenen Builds.

  10. Wenn Sie die Arbeit an der Builddefinition abgeschlossen haben, klicken Sie im Menü Datei auf <Name der Builddefinition> speichern (Tastenkombination: STRG+S).

    Die Builddefinition, die Sie erstellt haben, wird auf der Seite Nur bereinigen in Team Explorer.Weitere Informationen finden Sie unter Ausführen, Überwachen und Verwalten von Builds.