Hinzufügen eines Builds zur Warteschlange

Nachdem Sie eine oder mehrere Builddefinitionen erstellt und somit die Buildprozesse definiert haben, können Sie die Vorteile des Buildsystems nutzen. Die meisten Buildprozesse werden mit automatischen Triggern definiert. Unabhängig davon, ob die Builddefinition einen manuellen oder einen automatischen Trigger aufweist, können Sie einen Build bei Bedarf jederzeit manuell in die Warteschlange stellen.

Wichtig

Wenn Sie Visual Studio 2013 mit Visual Studio Team Foundation Server 2013 verwenden, können Probleme beim Ändern der Buildprozessparameter auftreten, wenn Sie einen Build in die Warteschlange stellen.Rufen Sie den Hotfix KB 2898341 ab.

Allgemeine Aufgaben	Unterstützender Inhalt
Fügen Sie einen öffentlichen Build zur Warteschlange hinzu, wenn Sie die neueste Version des Quellcodes auf dem Versionskontrollserver erstellen möchten. Verwenden Sie den Befehl TFSBuild start, um einen öffentlichen Build an der Eingabeaufforderung in die Warteschlange zu stellen.	Öffentliche Builds Befehl "Start" (Team Foundation Build)
Fügen Sie einen privaten Build zur Warteschlange hinzu, wenn Sie Änderungen erstellen möchten, die Sie in ein Shelveset eingefügt haben. Sie können private Builds (auch bekannt als "Buddybuilds") verwenden, um vor dem Einchecken Änderungen am Code zu überprüfen. Um einen privaten Build an der Eingabeaufforderung in die Warteschlange zu stellen, verwenden Sie den Befehl TFSBuild start mit der /shelveset-Option.	Private Builds Befehl "Start" (Team Foundation Build)
Wiederholen Sie den Vorgang für einen abgeschlossenen Build, wenn Sie einen öffentlichen oder privaten Build mit den gleichen Optionen wie bei einem bereits abgeschlossenen Build in die Warteschlange stellen möchten.	Wiederholen des Vorgangs für einen abgeschlossenen Build

Öffentliche Builds

Unabhängig davon, ob in einer Builddefinition ein automatischer Trigger angegeben ist, können Sie den Build manuell zur Warteschlange hinzufügen.

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 Startseite und anschließend Builds aus (Tastenkombination: STRG+0, B).

   3. Öffnen Sie auf der Seite Builds unter Favoriten-Builddefinitionen oder Alle Builddefinitionen das Kontextmenü für eine Builddefinition und wählen Sie Neuen Build in Warteschlange aus.

   Das Dialogfeld Build zur Warteschlange hinzufügen TeamProjectName wird angezeigt.

2. In der Liste Builddefinition wird die Builddefinition ausgewählt und darunter die Beschreibung angezeigt. Wenn Sie eine weitere Builddefinition in die Warteschlange stellen möchten, können Sie diese in der Liste auswählen.

3. Beachten Sie in der Liste Was möchten Sie erstellen?, dass der Eintrag Neueste Quellen ausgewählt ist.

4. (Optional) Wählen Sie in der Liste Buildcontroller einen anderen Buildcontroller als den Standardbuildcontroller aus.

5. (Optional) Wählen Sie in der Liste Priorität in Warteschlange einen der folgenden Werte aus: Hoch, Höher als normal, Normal, Niedriger als normal oder Niedrig.

   Im Feld Position wird die geschätzte Position des Builds in der Warteschlange angezeigt.

6. (Optional) Im Feld Ablageordner für diesen Build wird der Ort angezeigt, in dem nach dem Abschluss des Builds Binär- und Protokolldateien gespeichert werden. Wenn Sie die Ausgaben an einem anderen Speicherort speichern möchten, geben Sie in diesem Feld den Pfad zum Speicherort ein.

   Wichtig

   Wenn Sie diesen Wert ändern, müssen Sie einen Ordner angeben, der für die Verwendung als Ablageordner vorbereitet wurde.Sie können diesen Wert nicht ändern, wenn Sie Buildausgabe auf den Server kopieren als Stagingort für die Builddefinition angegeben haben.

   Siehe Einrichten von Ablageordnern.

7. (Optional) Auf der Registerkarte Parameter können Sie ausschließlich für diese Ausführung weitere Einstellungen der Builddefinition anzeigen und überschreiben.

   Wenn die Builddefinition auf der Standardvorlage oder der Upgradevorlage basiert, finden Sie weitere Informationen zu diesen Parametern unter Verwenden der Standardvorlage für Ihren Buildprozess bzw. Beheben von Problemen, die beim Upgrade auftreten können.

8. Wählen Sie die Option Warteschlange aus.

Private Builds

Sie stellen einen privaten Build in die Warteschlange, wenn Sie die Änderungen erstellen möchten, die Sie in ein Shelveset eingefügt haben. Sie können private Builds (auch bekannt als "Buddybuilds") verwenden, um vor dem Einchecken Änderungen am Code zu überprüfen. Wenn Sie für Ihre Änderungen vor dem Einchecken einen privaten Build ausführen, können Sie das Risiko verringern, dass diese zu Beschädigungen bei den Builds führen, die das Team regelmäßig ausführt (z. B. ein nächtlicher Build).

Unterschiede zwischen privaten Builds und öffentlichen Builds

Die Ergebnisse eines abgeschlossenen privaten Builds unterscheiden sich von denen eines abgeschlossenen öffentlichen Builds wie folgt:

• Ein privater Build ähnelt einem Build mit abgegrenztem Eincheckvorgang insofern, dass Sie Code erstellen, der Änderungen in einem Shelveset enthält. Nach einem privaten Build werden die Änderungen allerdings nicht automatisch eingecheckt, wie es nach einem abgegrenzten Eincheckbuild der Fall ist.

• Der Build bezeichnet Ihre Quellen nicht, erstellt keine Arbeitsaufgabe bei einem Fehler und verknüpft keine Changesets mit Arbeitsaufgaben.

• In Build Explorer wird der abgeschlossene Build neben dem folgenden Symbol angezeigt:

• Der abgeschlossene Build wird unter Verwendung des Formats Build N benannt, wobei N ein eindeutiger ganzzahliger Wert ist. Dieses Format unterscheidet sich vom Format öffentlicher Builds, das Sie mit dem Parameter Buildnummernformat angeben.

• Für jede Builddefinition geben Sie eine separate (und optional jeweils unterschiedliche) Beibehaltungsrichtlinie an, um die Anzahl der abgeschlossenen privaten Builds einzuschränken, die im System gespeichert werden.

Hinzufügen eines privaten Builds zur Warteschlange

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 Startseite und anschließend Builds aus (Tastenkombination: STRG+0, B).

   3. Öffnen Sie auf der Seite Builds unter Favoriten-Builddefinitionen oder Alle Builddefinitionen das Kontextmenü für eine Builddefinition und wählen Sie Neuen Build in Warteschlange aus.

   Das Dialogfeld Build zur Warteschlange hinzufügen TeamProjectName wird angezeigt.

2. In der Liste Builddefinition wird die Builddefinition ausgewählt und darunter die Beschreibung angezeigt. Wenn Sie eine weitere Builddefinition in die Warteschlange stellen möchten, können Sie diese in der Liste auswählen.

3. Wählen Sie in der Liste Was möchten Sie erstellen? den Eintrag Neueste Quellen mit Shelveset aus.

   Das Feld Shelvesetname wird angezeigt.

4. Führen Sie einen der folgenden Schritte aus:

   • Wenn bereits ein Shelveset vorhanden ist, geben Sie dessen Namen in das Feld Shelvesetname ein, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (…), um nach dem Shelveset zu suchen.

   • Wenn Sie ausstehende Änderungen aus dem Arbeitsbereich in ein Shelveset einfügen und diese Änderungen dann erstellen möchten, klicken Sie auf Erstellen.

5. (Optional) Wenn der Buildvorgang erfolgreich abgeschlossen wurde und Sie die Änderungen im Shelveset einchecken möchten, aktivieren Sie das Kontrollkästchen Änderungen nach erfolgreichem Buildvorgang einchecken.

   Wichtig

   Wenn Sie dieses Kontrollkästchen aktivieren, wird der Build nicht als privater Build, sondern als abgegrenzter Eincheckbuild ausgeführt.Weitere Informationen über abgegrenzte Eincheckbuilds finden Sie unter Verwenden eines abgegrenzten Eincheckbuildprozesses zur Überprüfung von Änderungen.

6. (Optional) Wählen Sie in der Liste Buildcontroller einen anderen Buildcontroller als den Standardbuildcontroller aus.

7. (Optional) Wählen Sie in der Liste Priorität in Warteschlange einen der folgenden Werte aus: Hoch, Höher als normal, Normal, Niedriger als normal oder Niedrig.

   Im Feld Position wird die geschätzte Position des Builds in der Warteschlange angezeigt.

8. (Optional) Auf der Registerkarte Parameter können Sie ausschließlich für diese Ausführung weitere Einstellungen der Builddefinition anzeigen und überschreiben.

   Wenn die Builddefinition auf der Standardvorlage oder der Upgradevorlage basiert, finden Sie weitere Informationen zu diesen Parametern unter Verwenden der Standardvorlage für Ihren Buildprozess bzw. Beheben von Problemen, die beim Upgrade auftreten können.

9. Wählen Sie die Option Warteschlange aus.

Wiederholen des Vorgangs für einen abgeschlossenen Build

Wenn Sie einige Änderungen an einem Buildprozess testen oder mit Optionen experimentieren, können Sie einen öffentlichen oder privaten Build schnell in die Warteschlange stellen. Voraussetzung ist, dass Sie die gleichen Optionen wie beim Einreihen eines bereits abgeschlossenen Builds in die Warteschlange verwenden.

• 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 Startseite und dann die Option Builds aus.

  3. Öffnen Sie auf der Seite Builds unter Meine Builds das Kontextmenü für einen abgeschlossenen Build, und wählen Sie Build wiederholen aus.