Freigeben über

Angeben der Buildtrigger und -gründe

  • Artikel

Sie können einen Build bei Bedarf jederzeit manuell in die Warteschlange stellen. Die Anforderungen des Teams werden aber in den meisten Fällen am besten durch -Buildprozesse erfüllt, die mit automatischen Triggern definiert werden. Beim Auslösen eines Builds wird ein bestimmter Grund in der Reason-Eigenschaft erfasst. In diesem Thema wird beschrieben, wie die verfügbaren Buildtrigger und -gründe beim Entwickeln des Buildprozesses verwendet werden.

  • Verwenden von Buildtriggern zum Erreichen von Teamzielen

    • Schützen des Teams vor Buildunterbrechungen

    • Beibehalten der Qualität durch Verwendung der fortlaufenden Integration

    • Überprüfen der Produktqualität durch Ausführen nächtlicher Buildüberprüfungstests (Build Verification Test, BVT)

  • Verwenden von automatischen Buildtriggern

    • Verwenden des Triggers für fortlaufende Integration zum Hinzufügen eines Builds zur Warteschlange beim Einchecken einer Änderung

    • Verwenden des Triggers Parallele Builds zum Hinzufügen eines Builds zur Warteschlange beim Einchecken einer Änderung (mit Einschränkungen hinsichtlich der Anzahl der Buildausführung)

    • Verwenden des Triggers für abgegrenzte Eincheckvorgänge zum Hinzufügen eines Builds zur Warteschlange, wenn ein Teammitglied eine Änderung einchecken möchte, und Blockieren der Änderung, wenn der Buildvorgang fehlschlägt

    • Verwenden des Zeitplantriggers zum Hinzufügen eines Builds zur Warteschlange in regelmäßigen Intervallen

  • Manuelles Hinzufügen eines Builds zur Warteschlange

    • Hinzufügen eines Builds zur Warteschlange

    • Hinzufügen eines privaten Builds zur Warteschlange

  • Verwenden von benutzerdefiniertem Code zum Hinzufügen eines Builds zur Warteschlange

  • Arbeiten mit Buildtriggern und -gründen

Verwenden von Buildtriggern zum Erreichen von Teamzielen

Schützen des Teams vor Buildunterbrechungen

Wenn ein Entwickler Änderungen eincheckt, die Fehler im Build verursachen, kann sich dies bei kleineren Teams als großes Ärgernis erweisen. Auf große Teams können hohe Kosten aufgrund von Produktivitätsverlusten und Planungsverzögerungen zukommen. Sie können den Trigger Abgegrenzter Eincheckvorgang verwenden, um die Codebasis vollständig oder teilweise vor diesem Problem zu schützen.

Beibehalten der Qualität durch Verwendung der fortlaufenden Integration

Fortlaufende Integration ist das Verfahren, den Code so häufig wie möglich in ein freigegebenes Repository zu integrieren. Während der Codeintegration kann Sie eine Buildunterbrechung oder ein Testfehler rechtzeitig über einen Fehler im Code informieren. Verwenden Sie den Trigger Fortlaufende Integration, um die fortlaufende Integration zu implementieren. Der Trigger Parallele Builds ähnelt dem Trigger Fortlaufende Integration und kann hilfreich sein, wenn das Buildsystem nicht leistungsfähig genug ist, um bei jedem Einchecken einen Buildvorgang durchzuführen.

Der Trigger Abgegrenzter Eincheckvorgang kann als auch rigoroser Ansatz für die fortlaufende Integration dienen. Der Trigger Fortlaufende Integration weist das Team auf Probleme hin, z. B. Buildunterbrechungen oder fehlgeschlagene Kernkomponententests. Im Gegensatz dazu verhindert der Trigger Abgegrenzter Eincheckvorgang, dass derartige Probleme in der Codebasis auftreten.

Weitere Informationen zur Verwendung des Buildsystems für die Unterstützung der fortlaufenden Integration finden Sie unter Einrichten eines CI-Builds.

Überprüfen der Produktqualität durch Ausführen nächtlicher Buildüberprüfungstests (Build Verification Test, BVT)

Sie können regelmäßige Testläufe planen, um die Qualität des Builds zu bewerten. Diese Tests werden oft als Buildüberprüfungstests (Build Verification Test, BVT) oder Feuerproben bezeichnet. Die Tests bestehen in der Regel aus einer umfassenden Suite von Tests, mit denen wesentliche Bereiche einer Anwendung in einem bestimmten Build überprüft werden. Verwenden Sie den Trigger Zeitplan, um eine nächtliche BVT-Ausführung zu implementieren.

Weitere Informationen zum Trigger Zeitplan finden Sie unter Verwenden des Zeitplantriggers zum Hinzufügen eines Builds zur Warteschlange in regelmäßigen Intervallen.

Verwenden von automatischen Buildtriggern

Für die Builddefinition müssen Sie einen Buildtrigger angeben. In den meisten Fällen ist es ratsam, dass der Buildprozess automatisch ausgeführt wird. Sie können einen der automatischen Trigger auswählen, die in diesem Abschnitt beschrieben werden.

Verwenden des Triggers für fortlaufende Integration zum Hinzufügen eines Builds zur Warteschlange beim Einchecken einer Änderung

Wenn Sie einen Build mit dem Trigger Fortlaufende Integration definieren, wird der Build immer dann in die Warteschlange gestellt, wenn ein Teammitglied eine Änderung eincheckt. Die Builddefinition Arbeitsbereich legt fest, welche Dateien die Builddefinition auslösen. Weitere Informationen zu Buildarbeitsbereichen finden Sie unter Arbeiten mit Buildarbeitsbereichen.

Für Builds, die von Fortlaufende Integration ausgelöst werden, wird IndividualCI als Reason zugewiesen.

Verwenden des Triggers "Parallele Builds", um in regelmäßigen Abständen mehrere Eincheckvorgänge zu erstellen

Wenn Sie einen Build mit dem Trigger Parallele Builds definieren, stellt das Buildsystem einen Build jedes Eincheckvorgangs in die Warteschlange, solange der Build nicht ausgeführt wird. Wenn der Build ausgeführt wird, wird gewartet, bis der Build abgeschlossen wurde. Danach wird ein anderer Build aus allen Eincheckvorgängen, die noch nicht erstellt wurden, in die Warteschlange gestellt. Sie können die Häufigkeit von Builds auch einschränken, indem Sie das Kontrollkästchen Höchstens in folgendem Intervall erstellen n Minuten aktivieren und einen ganzzahligen Wert zwischen 0 und 2147483647 eingeben.

Es kann beispielsweise sein, dass Sie nur einen Build-Agent verwenden, der alle 20 Minuten einen Build fertig stellt. Wenn Sie den Trigger Fortlaufende Integration verwenden und Ihr Team eingecheckten Code neun Mal zwischen 10 Uhr und 11 Uhr überprüft, wird das letzte Einchecken möglicherweise nicht vor 13 Uhr erstellt. Wenn Sie jedoch den Trigger Parallele Builds verwenden und als Intervall 60 Minuten angeben, sind die Buildvorgänge für dieselben Eincheckvorgänge möglicherweise bereits um 11:20 Uhr abgeschlossen

Die Builddefinition Arbeitsbereich legt fest, welche Dateien die Builddefinition auslösen. Weitere Informationen zu Buildarbeitsbereichen finden Sie unter Arbeiten mit Buildarbeitsbereichen.

Builds, die von Parallele Builds ausgelöst werden, wird BatchedCI als Reason zugewiesen.

Verwenden des Triggers für abgegrenzte Eincheckvorgänge zum Hinzufügen eines Builds zur Warteschlange, wenn ein Teammitglied eine Änderung einchecken möchte, und Blockieren der Änderung, wenn der Buildvorgang fehlschlägt

Sie können diesen Trigger nur in einem TFVC icon TFVC-Teamprojekt verwenden. In einem Git icon Git-Teamprojekt ist er nicht verfügbar.

Wenn Sie einen Build mit dem Trigger Abgegrenzter Eincheckvorgang definieren, werden Änderungen, die ein Teammitglied in das Versionskontrollsystem eincheckt, in ein Shelveset eingefügt und für die Erstellung in die Warteschlange eingereiht. Der Eincheckvorgang wird nur abgeschlossen, wenn der Build erfolgreich ist. Die Builddefinition Arbeitsbereich bestimmt, welche Dateien von der Builddefinition gesteuert werden. Weitere Informationen zu Buildarbeitsbereichen finden Sie unter Arbeiten mit Buildarbeitsbereichen.

Builds, die von Abgegrenzter Eincheckvorgang gestartet werden, wird CheckInShelveset als Reason zugewiesen.

Weitere Informationen zum Implementieren des Triggers Abgegrenzter Eincheckvorgang finden Sie unter Verwenden eines abgegrenzten Eincheckbuildprozesses zur Überprüfung von Änderungen. Weitere Informationen darüber, wie sich diese Art von Builddefinition auf das Team auswirkt, finden Sie unter Einchecken ausstehender Änderungen für einen abgegrenzten Eincheckbuild.

Verwenden des Zeitplantriggers zum Hinzufügen eines Builds zur Warteschlange in regelmäßigen Intervallen

Zeitplantrigger

Wenn Sie einen Build mit dem Trigger Zeitplan definieren und das Kontrollkästchen Erstellen, auch wenn sich seit dem letzten Build keine Änderungen ergeben haben deaktivieren, wird ein Build am angegebenen Tag und zur angegebenen Uhrzeit in die Warteschlange gestellt, falls seit der letzten Ausführung dieser Builddefinition Änderungen eingecheckt wurden. Der Build wird unabhängig davon in die Warteschlange gestellt, ob die Änderungen dem letzten gültigen Build zugeordnet waren.

Builds, die auf diese Weise ausgelöst werden, wird Schedule als Reason zugewiesen.

Tipp

Wenn Sie eine benutzerdefinierte Buildprozessvorlage entwickeln und in einem InvokeForReason-Abschnitt der Vorlage in der Reason-Eigenschaft den Wert Schedule auswählen, sollten Sie in den meisten Fällen ebenfalls ScheduleForced auswählen.

Zeitplantrigger (Grund: ScheduleForced)

Wenn Sie einen Build mit dem Trigger Zeitplan definieren und das Kontrollkästchen Erstellen, auch wenn sich seit dem letzten Build keine Änderungen ergeben haben aktivieren, wird ein Build am angegebenen Tag und zur angegebenen Uhrzeit in die Warteschlange gestellt. Der Build wird unabhängig davon in die Warteschlange gestellt, ob Änderungen eingecheckt wurden.

Builds, die auf diese Weise ausgelöst werden, wird ScheduleForced als Reason zugewiesen.

Tipp

Wenn Sie eine benutzerdefinierte Buildprozessvorlage entwickeln und in einem InvokeForReason-Abschnitt der Vorlage in der Reason-Eigenschaft den Wert ScheduleForced auswählen, sollten Sie in den meisten Fällen ebenfalls Schedule auswählen.

Manuelles Hinzufügen eines Builds zur Warteschlange

In bestimmten Fällen soll ein Buildvorgang möglicherweise nicht automatisch ausgeführt werden.

  • Die Builddefinition ist eventuell nicht für automatische Ausführungen bereit, da sie sich noch in der Entwicklungsphase befindet.

  • Möglicherweise möchten Sie einen bestimmten Buildvorgang nur manuell ausführen.

In solchen Fällen können Sie den Trigger Manuell auswählen. Die Builddefinition wird nur dann ausgeführt, wenn ein Teammitglied sie manuell in die Warteschlangen stellt.

Hinzufügen eines Builds zur Warteschlange

Sie können jede Builddefinition manuell in die Warteschlange stellen, auch wenn sie mit einem anderen Buildtrigger als Manuell definiert ist. Wenn Sie einen Build manuell in die Warteschlange stellen, wird Reason auf Manual festgelegt. Weitere Informationen über das manuelle Hinzufügen eines Builds zur Warteschlange finden Sie unter Hinzufügen eines Builds zur Warteschlange.

Hinzufügen eines privaten Builds zur Warteschlange

Wenn Sie Änderungen erstellen möchten, die Sie in ein Shelveset eingefügt haben, können Sie einen privaten Build (auch als "Buddybuild" bekannt) verwenden, um die Änderungen am Code vor dem Einchecken zu überprüfen. Wenn Sie einen privaten Build manuell in die Warteschlange stellen, wird Reason auf ValidateShelveset festgelegt. Weitere Informationen zum Hinzufügen eines privaten Builds zur Warteschlange finden Sie unter Hinzufügen eines Builds zur Warteschlange.

Verwenden von benutzerdefiniertem Code zum Erstellen eines abgeschlossenen Builds

Mithilfe von Klassen im Microsoft.TeamFoundation.Build-Namespace können Sie benutzerdefinierten Code entwickeln, der einen abgeschlossenen Build erstellt. Wenn ein Build auf diese Weise in die Warteschlange gestellt wurde, wird Reason auf UserCreated festgelegt. Weitere Informationen finden Sie unter Erweitern von Team Foundation: Build

Arbeiten mit Buildtriggern und -gründen

Sie können Trigger und Gründe im Buildprozess wie folgt verwenden:

  • Legen Sie den Trigger für den Buildprozess fest: Klicken Sie in der Builddefinition auf die Registerkarte Trigger, und wählen Sie dann den Trigger aus, der den Anforderungen des Teams am besten entspricht. Weitere Informationen zum Erstellen einer Builddefinition finden Sie unter Erstellen oder Bearbeiten einer Builddefinition.

  • Definieren Sie, welche Buildgründe von einem benutzerdefinierten Buildprozess akzeptiert werden: Sie können die InvokeForReason-Aktivität verwenden, um ein Segment des Buildprozesses einzuschließen, das nur in Builds ausgeführt werden soll, die aus einem bestimmten Grund ausgeführt wurden. Weitere Informationen finden Sie im Artikel zu Team Foundation-Buildaktivitäten: InvokeForReason.