Erstellen oder Bearbeiten einer Builddefinition

  • Artikel

Nachdem Sie das Buildsystem bereitgestellt haben, sind Sie in der Lage, einen Buildprozess zu definieren, um Ihren Code zu kompilieren, Tests auszuführen und viele andere wichtige Funktionen für das Team zu nutzen.

  1. Vergewissern Sie sich in Team Explorer in Visual Studio, dass Sie mit dem Teamprojekt verbunden sind (Tastatur: STRG+0, C), und öffnen Sie anschließend die Seite Builds Icon Builds (Tastatur: STRG+0, B).

  2. Wählen Sie den Link Neue Builddefinition oder wählen Sie ein Build aus, öffnen dann das Kontextmenü und wählen Builddefinition bearbeiten aus.

    Tipp

    Konfigurieren Sie einen Buildcontroller, wenn die Fehlermeldung "TF225001" angezeigt wird.

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

  4. 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 Ermöglicht das Einstellen von neuen Builds in die Warteschlange durch Trigger oder Benutzer, sie verbleiben jedoch im angehaltenen Zustand.

    • Deaktiviert Neue Builds können nicht von Triggern oder Benutzern in die Warteschlange gestellt werden.

  5. Geben Sie auf der Registerkarte Trigger das Ereignis an, über das diese Builddefinition ausgeführt werden soll. Siehe Angeben der Buildtrigger und -gründe.

  6. Auf der Registerkarte Quelleinstellungen:

    • TFVC icon TFVC: Legen Sie für die Tabelle Arbeitsordner die Ordner für die Versionskontrolle fest, in dem die für den Buildprozess erforderlichen Dateien enthalten sind.

      Tipp

      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).Siehe Arbeiten mit Buildarbeitsbereichen.

    • Git icon Git: Legen Sie Repository und Verzweigungen fest, die die für den Buildprozess erforderlichen Dateien enthalten.

      Tipp

      In der Liste der Verzweigungen, die für eine fortlaufende Integration (CI) und parallele Builds überwacht werden, können Sie Platzhalter verwenden.Beispielsweise können Sie refs/heads/feature* angeben, um die Verzweigungen refs/heads/featureA und refs/heads/featureB zu überwachen.

  7. Wenn auf der Registerkarte Build-Standardwerte in der Liste Buildcontroller mehrere Buildcontroller angezeigt werden, wählen Sie den Buildcontroller aus, der vom Buildsystem zum Verarbeiten dieser Builddefinition verwendet werden soll.

    Wenn die Teamprojektauflistung über Visual Studio Online gehostet wird und die Anforderungen des Teams durch einen einzelnen Standardbuild-Agent erfüllt werden können, wählen Sie Gehosteter Buildcontroller aus. Siehe Gehosteter Buildcontroller.

  8. 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. Siehe Einrichten von Ablageordnern.

    • Buildausgabe auf den Server kopieren: Wählen Sie diese Option, um die generierte Ausgabe auf den Team Foundation Server zu kopieren.

  9. 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 einfach zu definieren, wählen Sie Details anzeigen und dann in der Liste Buildprozessdatei die Option Standardvorlage aus. Siehe Verwenden der Standardvorlage für Ihren Buildprozess.

    • 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. Siehe Anpassen der Buildprozessvorlage.

  10. 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 Hinzufügen eines Builds zur 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.

  11. Wenn Sie die Arbeit an der Builddefinition abgeschlossen haben, wählen Sie im Menü Datei die Option Speichern <Name der Builddefinition> aus (Tastenkombination: STRG+S).

    Die von Ihnen erstellte Builddefinition wird im Team Explorer auf der Seite Builds angezeigt. Siehe Ausführen, Überwachen und Verwalten von Builds.