Freigeben über

Stellen eines Builds in die Warteschlange

  • Artikel

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 automatischem Trigger 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.

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.

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.

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.

Erforderliche Berechtigungen

Zum Durchführen dieser Schritte, muss die Berechtigung auf Builds zur Warteschlange hinzufügenZulassen festgelegt werden.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So stellen Sie einen öffentlichen Build in Visual Studio in die 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 Symbol "Startseite"Startseite und dann die Option Symbol "Builds"Builds aus.

    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 "Teamprojektname" zur Warteschlange hinzufügen 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. Lassen Sie in der Liste Was möchten Sie erstellen? den Eintrag Neueste Quellen ausgewählt.

  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) wird das Feld Ablageordner für diesen Build den Speicherort an, an dem Ausgaben wie Binärdateien und Protokolldateien gespeichert werden, wenn der Build abgeschlossen wird.Wenn Sie die Ausgaben an einem anderen Speicherort speichern möchten, geben Sie in diesem Feld den Pfad zum Speicherort ein.

    Wichtiger HinweisWichtig

    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 der Stagingspeicherort 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 Definieren eines auf der Standardvorlage basierenden Buildprozesses bzw. Verwenden von Legacy-Buildprozessen.

  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 einen privaten Build der Änderungen ausführen, bevor Sie sie einchecken, können Sie das Risiko verringern, dass sie alle Builds, die das Team regelmäßig ausführt, wie der nächtliche Build verursachen.

ms181722.collapse_all(de-de,VS.110).gifUnterschiede 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.

  • Bei den folgenden Buildprozessparametern wird angenommen, dass sie unabhängig von der in der Builddefinition angegebenen Einstellung den Wert False und somit keine Auswirkungen haben:

    • Quellen mit Bezeichnungen versehen

    • Bei Fehler Arbeitsaufgabe erstellen

    • Changesets und Arbeitsaufgaben zuordnen

  • In Build Explorer wird der abgeschlossene Build neben dem folgenden Symbol angezeigt: ms181722.Icon_BldPrivateBuild(de-de,VS.110).gif

  • Der abgeschlossene Build wird benannt, indem das Format BuildN verwendet, 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.

ms181722.collapse_all(de-de,VS.110).gifHinzufügen eines privaten Builds zur Warteschlange

Erforderliche Berechtigungen

Zum Durchführen dieser Schritte, muss die Berechtigung auf Builds zur Warteschlange hinzufügenZulassen festgelegt werden.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So stellen Sie einen privaten Build in Visual Studio in die 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 Symbol "Startseite"Startseite und dann die Option Symbol "Builds"Builds aus.

    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 "Teamprojektname" zur Warteschlange hinzufügen 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 Sie die Änderungen im Shelveset bei einem erfolgreichen Buildvorgang einchecken möchten, aktivieren Sie das Kontrollkästchen Änderungen nach erfolgreichem Buildvorgang einchecken.

    Wichtiger HinweisWichtig

    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 Definieren eines abgegrenzten Eincheckbuildprozesses zur Überprüfung der Ä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) führen Sie folgende Schritte aus, um den Ordner anzugeben, in dem die, Ausgaben wie Binärdateien, des Build heruntergeladen werden:

    HinweisHinweis

    Ignorieren Sie das Feld Ablageordner für diesen Build. Dieses hat bei privaten Builds keine Auswirkungen.

    1. Klicken Sie auf die Registerkarte Parameter, und erweitern Sie dann die Gruppe Erweitert.

    2. Geben Sie im Feld Privater Ablagespeicherort den UNC-Pfad des Ordners ein, in dem die Ausgabe nach Abschluss des Buildvorgangs gespeichert werden soll.

      HinweisHinweis

      • Wenn Sie diesen Ordner nicht angeben, schlägt der Buildvorgang zwar nicht fehl, aber im Buildprotokoll wird eine Warnung angezeigt.

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

  9. (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 Definieren eines auf der Standardvorlage basierenden Buildprozesses bzw. Verwenden von Legacy-Buildprozessen.

  10. 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.

So wiederholen Sie den Vorgang für einen abgeschlossenen Build auf der Seite "Builds"

  • 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. Öffnen Sie auf der Seite Builds unter Meine Builds das Kontextmenü für einen abgeschlossenen Build, und wählen Sie Build wiederholen aus.