Aufgabengruppen für Builds und Versionen (klassische)

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Hinweis

In Microsoft Team Foundation Server (TFS) 2018 und früheren Versionen werden Build- und Release-Pipelines als Definitionen bezeichnet, Ausführungen werden als Builds bezeichnet, Dienstverbindungen werden als Dienstendpunkte bezeichnet, Stages werden als Umgebungen bezeichnet und Aufträge werden als Phasen bezeichnet.

Hinweis

Aufgabengruppen werden in YAML-Pipelines nicht unterstützt. Stattdessen können Sie in diesem Fall Vorlagen verwenden. Siehe YAML-Schemareferenz.

Eine Aufgabengruppe ermöglicht es Ihnen, eine Reihe von Vorgängen, die bereits in einem Build oder einer Releasepipeline definiert sind, in eine einzelne wiederverwendbare Aufgabe zu kapseln, die einem Build- oder Releasepipeline wie jedem anderen Vorgang hinzugefügt werden kann. Sie können auch die Parameter aus dem gekapselten Task als Konfigurationsvariablen extrahieren und den Rest der Taskinformationen abstrahieren.

Die neue Aufgabengruppe wird automatisch dem Aufgabenkatalog hinzugefügt, bereit, um anderen Release- und Buildpipelinen hinzuzufügen. Aufgabengruppen werden auf Projektebene gespeichert und sind außerhalb des Projektbereichs nicht zugänglich.

Aufgabengruppen sind eine Möglichkeit, die Bereitstellungsschritte für alle Ihre Anwendungen zu standardisieren und zentral zu verwalten. Wenn Sie eine Aufgabengruppe in Ihre Definitionen einschließen und dann eine Änderung zentral an der Aufgabengruppe vornehmen, wird die Änderung automatisch in allen Definitionen, die die Aufgabengruppe verwenden, angezeigt. Es ist nicht notwendig, jede einzeln zu ändern.

Bevor Sie eine Aufgabengruppe erstellen...

  • Stellen Sie sicher, dass alle Aufgaben, die Sie in eine Aufgabengruppe einschließen möchten, ihre Parameter als Variablen definiert sind, z. B. $(MyVariable), wo Sie diese Parameter konfigurieren möchten, wenn Sie die Aufgabengruppe verwenden. Variablen, die in den Vorgängen verwendet werden, werden automatisch extrahiert und in Parameter für die Aufgabengruppe konvertiert. Die Werte dieser Konfigurationsvariablen werden in Standardwerte für die Aufgabengruppe konvertiert.

  • Wenn Sie einen Wert (anstelle einer Variable) für einen Parameter angeben, wird dieser Wert zu einem festen Parameterwert und kann nicht als Parameter für die Taskgruppe verfügbar gemacht werden.

  • Parameter der gekapselten Vorgänge, für die Sie einen Wert (anstelle einer Variable) angegeben haben, oder Sie haben keinen Wert bereitgestellt, sind nicht in der Taskgruppe konfigurierbar, wenn Sie einer Build- oder Releasepipeline hinzugefügt wurden.

  • Vorgangsbedingungen (z. B. "Diese Aufgabe nur ausführen, wenn ein vorheriger Vorgang fehlgeschlagen ist" für eine PowerShell-Skriptaufgabe ) kann in einer Taskgruppe konfiguriert werden, und diese Einstellungen werden mit der Taskgruppe beibehalten.

  • Wenn Sie die Aufgabengruppe speichern, können Sie einen Namen und eine Beschreibung für die neue Aufgabengruppe angeben und eine Kategorie auswählen, in der sie im Dialogfeld "Aufgabenkatalog " angezeigt werden soll. Sie können auch die Standardwerte für jede der Parameter ändern.

  • Wenn Sie einen Build oder eine Version warteschlangen, werden die gekapselten Vorgänge extrahiert, und die Werte, die Sie für die Aufgabengruppenparameter eingegeben haben, werden auf die Aufgaben angewendet.

  • Änderungen, die Sie an einer Aufgabengruppe vornehmen, werden in jeder Instanz der Aufgabengruppe angezeigt.

Erstellen einer Aufgabengruppe

  1. Stellen Sie sicher, dass alle Aufgaben, die Sie einschließen möchten, keine verknüpften Parameter enthalten. Dies ist die einfache Möglichkeit, alle Verknüpfungen im Einstellungsbereich für den gesamten Prozess zu deaktivieren.

    Unlinking parameters for all tasks

  2. Wählen Sie eine Sequenz von Vorgängen in einer Build- oder Releasepipeline aus, öffnen Sie das Kontextmenü, und wählen Sie dann " Aufgabengruppe erstellen" aus.

    Creating a task group from a release pipeline list of tasks

  3. Geben Sie einen Namen und eine Beschreibung für die neue Aufgabengruppe und die Kategorie (Registerkarte im Bereich "Aufgaben hinzufügen") an, zu der Sie sie hinzufügen möchten.

  4. Nachdem Sie "Erstellen" ausgewählt haben, wird die neue Aufgabengruppe erstellt und ersetzt die ausgewählten Aufgaben in Ihrer Pipeline.

  5. Alle '$(vars)' aus den zugrunde liegenden Aufgaben, ohne die vordefinierten Variablen, werden als obligatorische Parameter für die neu erstellte Aufgabengruppe angezeigt.

    Angenommen, Sie haben eine Aufgabeneingabe $(foobar), die Sie nicht parameterisieren möchten. Wenn Sie jedoch eine Aufgabengruppe erstellen, wird die Vorgangseingabe in den Aufgabengruppenparameter "foobar" konvertiert. Jetzt können Sie den Standardwert für den Aufgabengruppenparameter 'foobar' als $(foobar) angeben. Dadurch wird sichergestellt, dass die erweiterte Aufgabe die gleiche Eingabe erhält, wie sie beabsichtigt ist.

  6. Speichern Sie Ihre aktualisierte Pipeline.

Verwalten von Aufgabengruppen

Alle Aufgabengruppen, die Sie im aktuellen Projekt erstellen, werden auf der Seite "Aufgabengruppen" Azure Pipelines aufgeführt.

Listing task groups

Verwenden Sie den Befehl "Verknüpfung exportieren", um eine Kopie der Aufgabengruppe als JSON-Pipeline zu speichern, und das Symbol "Importieren ", um zuvor gespeicherte Aufgabengruppendefinitionen zu importieren. Verwenden Sie dieses Feature, um Aufgabengruppen zwischen Projekten und Unternehmen zu übertragen oder Kopien Ihrer Aufgabengruppen zu replizieren und zu speichern.

Wählen Sie einen Aufgabengruppennamen aus, um die Detailseite zu öffnen.

Managing a task group

  • Auf der Seite "Aufgaben " können Sie die Aufgaben bearbeiten, die die Aufgabengruppe bilden. Für jede gekapselte Aufgabe können Sie die Parameterwerte für die nicht variablen Parameter ändern, die vorhandenen Parametervariablen bearbeiten oder Parameterwerte in und aus Variablen konvertieren. Wenn Sie die Änderungen speichern, werden alle Definitionen, die diese Aufgabengruppe verwenden, die Änderungen abrufen.

Alle Variablenparameter der Aufgabengruppe werden als obligatorische Parameter in der Pipelinedefinition angezeigt. Sie können auch den Standardwert für die Aufgabengruppenparameter festlegen.

  • Auf der Registerkarte " Verlauf " können Sie den Verlauf der Änderungen an der Gruppe sehen.

  • Auf der Registerkarte "Verweise " können Sie Listen aller Build- und Releasepipelinen und anderer Aufgabengruppen erweitern, die diese Aufgabengruppe verwenden (Referenz). Dies ist nützlich, um sicherzustellen, dass Änderungen keine unerwarteten Auswirkungen auf andere Prozesse haben.

Erstellen von Vorschauen und aktualisierten Versionen von Aufgabengruppen

Alle integrierten Aufgaben in Azure Pipelines und TFS sind versioniert. Dadurch können Build- und Releasepipelinen weiterhin die vorhandene Version einer Aufgabe verwenden, während neue Versionen entwickelt, getestet und veröffentlicht werden. In Azure Pipelines können Sie ihre eigenen benutzerdefinierten Aufgabengruppen versionieren, damit sie sich auf dieselbe Weise verhalten und dieselben Vorteile bieten.

  1. Nachdem Sie die Bearbeitung einer Aufgabengruppe abgeschlossen haben, wählen Sie " Als Entwurf speichern " anstelle von "Speichern" aus.

    Saving a draft update to a task group

  2. Der Zeichenfolgentest wird an die Versionsnummer der Taskgruppe angefügt. Wenn Sie mit den Änderungen zufrieden sind, wählen Sie "Entwurf veröffentlichen" aus. Sie können auswählen, ob sie als Vorschau oder als produktionsfähige Version veröffentlicht werden sollen.

    Publishing a draft version of a task group

  3. Sie können jetzt die aktualisierte Aufgabengruppe in Ihren Build- und Releaseprozessen verwenden; entweder durch Ändern der Versionsnummer der Aufgabengruppe in einer vorhandenen Pipeline oder durch Hinzufügen aus dem Bereich "Aufgaben hinzufügen ".

    Using a preview version of a task group

    Wie bei den integrierten Vorgängen ist die Standardeinstellung beim Hinzufügen einer Aufgabengruppe die höchste Nichtvorschauversion.

  4. Nachdem Sie den Test der aktualisierten Aufgabengruppe abgeschlossen haben, wählen Sie " Vorschau veröffentlichen" aus. Die Vorschauzeichenfolge wird aus der Versionsnummerzeichenfolge entfernt. Es wird jetzt in Definitionen als "produktionsfähige" Version angezeigt.

    Publishing a preview version of a task group

  5. In einer Build- oder Releasepipeline, die diese Aufgabengruppe bereits enthält, können Sie jetzt die neue Version "produktionsbereit" auswählen. Wenn Sie die Aufgabengruppe aus dem Bereich "Aufgaben hinzufügen " hinzufügen, wählt sie automatisch die neue "produktionsfähige" Version aus.

    Using an updated version of a task group

Arbeiten mit Aufgabengruppenversionen

Alle Aufgabengruppenupdates können ein Neben- oder Hauptversionsupdate sein.

Nebenversion

Aktion: Sie speichern die Taskgruppe direkt nach dem Bearbeiten, anstatt sie als Entwurf zu speichern.

Wirkung: Die Versionsnummer ändert sich nicht. Sagen wir, Sie haben eine Aufgabengruppe der Version 1.0. Sie können eine beliebige Anzahl von Nebenversionsupdates haben, z. B. 1.1, 1.21.3 usw. In Ihrer Pipeline wird die Aufgabengruppenversion angezeigt, da 1.* die neuesten Änderungen automatisch in der Pipelinedefinition angezeigt werden.

Grund: Dies sollte eine kleine Änderung in der Aufgabengruppe sein und Sie erwarten, dass die Pipelines diese neue Änderung verwenden, ohne die Version in der Pipelinedefinition zu bearbeiten.

Hauptversion

Aktion: Sie speichern die Taskgruppe als Entwurf, und erstellen Sie dann eine Vorschau, überprüfen Sie die Aufgabengruppe, und veröffentlichen Sie dann die Vorschau als Hauptversion.

Wirkung: Die Aufgabengruppe stoßt auf eine neue Version. Sagen wir, Sie haben eine Aufgabengruppe der Version 1.*. Eine neue Version wird als 2.*, 3.*4.* usw. veröffentlicht. Und eine Benachrichtigung über die Verfügbarkeit neuer Versionen wird in allen Pipelinedefinitionen angezeigt, in denen diese Aufgabengruppe verwendet wird. Der Benutzer muss explizit auf neue Version der Aufgabengruppe in Pipelines aktualisieren.

Grund: Wenn Sie eine erhebliche Änderung haben, die die vorhandenen Pipelines unterbrechen kann, möchten Sie es testen und als neue Version bereitstellen. Benutzer können sich entscheiden, auf neue Version zu aktualisieren oder auf derselben Version zu bleiben. Diese Funktionalität entspricht einem normalen Aufgabenversionsupdate.

Wenn ihr Aufgabengruppenupdate jedoch keine unterbrechungsende Änderung ist, sie aber zuerst überprüfen und dann Pipelines erzwingen möchten, um die neuesten Änderungen zu nutzen, können Sie die folgenden Schritte ausführen.

  1. Aktualisieren Sie die Taskgruppe mit ihren gewünschten Änderungen, und speichern Sie sie als Entwurf. Eine neue Taskgruppe "<Taskgroupname-Entwurf>" wird erstellt, die die von Ihnen durchgeführten Änderungen enthält. Und diese Entwurfsaufgabengruppe ist für Sie zugänglich, um sie in Ihren Pipelines zu nutzen.
  2. Anstatt als Vorschau zu veröffentlichen, können Sie diese Entwurfsaufgabengruppe in Ihrer Testpipeline direkt nutzen.
  3. Überprüfen Sie diese neue Aufgabengruppe in Ihrer Testpipeline, und sobald Sie sicher sind, kehren Sie zu Ihrer Hauptaufgabesgruppe zurück, und führen Sie die gleichen Änderungen aus, und speichern Sie sie direkt. Dies wird als Nebenversionsupdate verwendet.
  4. Die neuen Änderungen werden nun in allen Pipelines angezeigt, in denen diese Aufgabengruppe verwendet wird.
  5. Jetzt können Sie Ihre Entwurfsaufgabengruppe löschen.

Hilfe und Support