Teilen über


Steuern der Git-Entwicklung aus einem Arbeitselement in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Eine der Möglichkeiten, wie Ihr Team die Entwicklung vorantreiben und dabei synchronisiert bleiben kann, besteht darin, Ihre Arbeitselemente mit den Objekten zu verknüpfen, die während der Entwicklung erstellt werden, z. B. Branches, Commits, Pull Requests und Builds. Sie können mit dieser Verknüpfung beginnen, indem Sie einen Branch aus einem oder mehreren Arbeitselementen heraus erstellen. Später können Sie Pull Requests erstellen, Commits schnell öffnen und eine Aufzeichnung von Entwicklungsvorgängen verwalten, die zur Ausführung bestimmter Arbeiten ausgeführt wurden.

In diesem Artikel erfahren Sie, wie Sie die folgenden Aufgaben erledigen können:

  • Erstellen eines neuen Branchs oder Pull Requests aus einem Arbeitselement
  • Abschließen des Pull Requests
  • Durchführen eines Squashmerges
  • Erstellen eines Branchs für mehrere Arbeitselemente
  • Verknüpfen eines Arbeitselements mit vorhandenen Entwicklungs- und Buildobjekten

In diesem Artikel wird das Erstellen neuer Branches, das Hinzufügen von Links zu Commits sowie das Hinzufügen von Pull Requests zu einem Git-Repository behandelt, das in Azure DevOps gehostet wird. Informationen zum Verknüpfen mit GitHub-Commits und Pull Requests finden Sie unter Verknüpfen von GitHub-Commits und Pull Requests mit Arbeitselementen.

Tipp

Sie können automatische Verknüpfung und andere Einstellungen einrichten, die Arbeitselemente mit Git-Commits, Pull Requests, Builds und mehr verknüpfen. Weitere Informationen finden Sie in den folgenden Ressourcen:

Development-Steuerelement

Das Development-Steuerelement (Entwicklung) zeichnet alle Git-Entwicklungsprozesse auf, die das Abschließen des Arbeitselements unterstützen. Dieses Steuerelement kann Ihrem Team Informationen anzeigen, die erforderlich sind, um den nächsten Entwicklungsschritt zu unternehmen, und die Navigationsschritte zum Erledigen allgemeiner Entwicklungsaufgaben minimieren. Es unterstützt außerdem die Nachverfolgbarkeit und bietet so Einblick in alle Branches, Commits, Pull Requests und Builds im Zusammenhang mit dem Arbeitselement.

Screenshot: Arbeitselementformular, Steuerelement „Entwicklung“.

Screenshot: Arbeitselementformular, Steuerelement „Entwicklung“, Azure DevOps Server 2019.

Daraus können Sie schnell auf Branches, Pull Requests und Commits zugreifen, die mit dem Arbeitselement verknüpft sind. Außerdem können Sie einen Pull Request für einen Branch starten, den Sie aus dem Arbeitselement erstellt oder damit verknüpft haben.

Denken Sie daran, dass das Development-Steuerelement nur im Arbeitselementformular im Webportal angezeigt wird. Die Erfahrung für die Nachverfolgung von Arbeitselementen und die Formulare, die in Visual Studio oder anderen unterstützten Clients angezeigt werden, zeigen nicht mehrere der Features an, die im Webportal verfügbar sind.

Voraussetzungen

  • Herstellen einer Verbindung mit einem Projekt. Wenn Sie noch kein Projekt haben, erstellen Sie eins.
  • Sie müssen einem Projekt als Mitglied der Sicherheitsgruppe Mitwirkende oder Projektadministratoren hinzugefügt werden. Um hinzugefügt zu werden, fügen Sie einem Projekt oder Team Benutzer hinzu.
  • Zum Anzeigen oder Ändern von Arbeitselementen müssen die Berechtigungen Arbeitselemente in diesem Knoten anzeigen und Arbeitselemente in diesem Knoten bearbeiten für Sie auf Zulassen festgelegt sein. Standardmäßig sind diese Berechtigungen für die Gruppe Mitwirkende festgelegt. Weitere Informationen finden Sie unter Festlegen von Berechtigungen und Zugriff für die Arbeitsnachverfolgung.
  • Herstellen einer Verbindung mit einem Projekt. Wenn Sie noch kein Projekt haben, erstellen Sie eins.
  • Sie müssen einem Projekt als Mitglied der Sicherheitsgruppe Mitwirkende oder Projektadministratoren hinzugefügt werden. Um hinzugefügt zu werden, fügen Sie einem Projekt oder Team Benutzer hinzu.
  • Zum Anzeigen oder Ändern von Arbeitselementen müssen die Berechtigungen Arbeitselemente in diesem Knoten anzeigen und Arbeitselemente in diesem Knoten bearbeiten für Sie auf Zulassen festgelegt sein. Standardmäßig sind diese Berechtigungen für die Gruppe Mitwirkende festgelegt. Weitere Informationen finden Sie unter Festlegen von Berechtigungen und Zugriff für die Arbeitsnachverfolgung.

Workflowprozess

Erwägen Sie das Erstellen eines neuen Branchs, wenn keine verknüpften Codeartefakte vorhanden sind. Wenn ein Branch vorhanden ist, aber keine Pull Requests, erwägen Sie, einen Pull Request zu erstellen. Dies ist eine typische Workflowsequenz beim Arbeiten mit einem Git-Repository.

  1. Beginnen Sie mit der Arbeit an dem Arbeitselement, indem Sie einen Branch erstellen. Sie können einen neuen Git-Branch aus dem Abschnitt „Entwicklung“ hinzufügen...

    Screenshot des Steuerelements „Entwicklung“, Link „Branch erstellen“.

    ... oder im  Menü „Aktionen“ des Formulars.

    User Story-Arbeitselementformular, Menü „Aktion“, Neuen Branch hinzufügen.

    Benennen Sie den Branch, und wählen Sie das Repository aus.

    Dialogfeld „Branch erstellen“

    Wenn Sie Branches erstellen, werden sie automatisch mit dem Arbeitselement verknüpft.

    Hinweis

    Sie können einen Branch erst erstellen, wenn Sie dem Mainbranch Dateien hinzugefügt haben. Es wird empfohlen, diesen mit main oder einer anderen charakteristischen Bezeichnung zu bezeichnen. Das System fügt dem anfänglichen Repository, das mit jedem neuen Projekt erstellt wird, automatisch eine Infodatei (README) hinzu.

  2. Das System wird mit dem Repository und Branch geöffnet, die Sie erstellt haben.

    Sie können eine Datei im Webportal bearbeiten.

    Wenn Sie umfangreiche Dateibearbeitungen haben oder Dateien hinzufügen müssen, können Sie auch in Visual Studio oder einer anderen unterstützten IDE arbeiten. Fügen Sie einen neuen lokalen Branch aus dem von Ihnen erstellten Branch hinzu. Weitere Informationen finden Sie unter Aktualisieren von Code mit Fetch und Pull, Herunterladen von Änderungen mit Fetch. (Obwohl jeder Codebearbeitungs- und Commitprozess funktioniert, arbeiten wir am besten mit einer Edition von Visual Studio.)

  3. Fügen Sie Dateien in dem Branch hinzu, den Sie erstellt haben, oder ändern Sie Dateien.

    Committen und pushen Sie in Visual Studio oder einer anderen unterstützten IDE Änderungen aus Ihrem lokalen Branch in das Repository.

    Änderungen committen und pushen

    Wenn Sie zum ersten Mal Änderungen von einem neuen Branch pushen, sollen Sie den Branch veröffentlichen, bevor Sie Änderungen pushen. Weitere Informationen finden Sie unter Freigeben von Code mit Push.

  4. Erstellen Sie einen Pull Request aus dem Arbeitselementformular.

    Sie erstellen einen Pull Request, um die Änderungen, die Sie an einem Mainbranch vorgenommen haben, zusammenzuführen und Ihre Änderungen von anderen Mitgliedern Ihres Teams überprüfen zu lassen.

    Screenshot des Steuerelements „Entwicklung“, Link „Pull Request erstellen“.

  5. Ihre Ansicht wechselt zu Code, Seite „Pull Requests“. Schließen Sie die Erstellung des Pull Requests wie gezeigt ab.

    Codeansicht, Seite „Pull Request“.

    Hinweis

    Nachdem Sie einen Pull Request erstellt haben, können Sie erst dann wieder einen neuen Pull Request für denselben Branch erstellen, nachdem Sie den vorherigen Pull Request abgeschlossen haben.

    Seite „Pull Request“, „Pull Request erstellen“.

    Aktivieren Sie das Kontrollkästchen Squash für Änderungen beim Mergen, und schließen Sie dann die Zusammenführung ab.

    Dialogfeld „Pull Request abschließen“, Squashmerge aktiviert

  6. Nach Abschluss sollte ein ähnlicher Bildschirm wie der folgende angezeigt werden.

    Pull Request, Benachrichtigung über Abschluss

  7. Öffnen Sie das Arbeitsaufgabenformular, oder aktualisieren Sie das Formular, erweitern Sie den Abschnitt "Entwicklung " (wählen Sie " Entwicklung maximieren") aus, und Sie sehen die Links, die hinzugefügt wurden, um die abgeschlossenen Vorgänge zu unterstützen.

    Screenshot des Arbeitselement-Formulars, Abschnitt Entwicklung, Links hinzugefügt.

Erstellen eines Branchs für mehrere Arbeitselemente

Sie können auch eine neue Verzweigung aus der Arbeitsaufgabe hinzufügen, die im Backlog oder Board aufgeführt ist, ohne die Arbeitsaufgabe öffnen zu müssen. Mithilfe von Mehrfachauswahl können Sie mehrere Arbeitselemente auswählen und einen neuen Branch erstellen, in dem sie alle mit dem Branch verknüpft sind.

Hier wählen wir beispielsweise die ersten fünf Elemente aus, die mit einem neuen Branch verknüpft werden sollen.

Screenshot des Auswählens mehrerer Elemente aus dem Backlog, Link „Branch erstellen“.

Außerdem geben wir den Namen des Branchs an.

Dialogfeld „Neuen Branch erstellen“

Alle im Abschnitt "Entwicklung" aufgeführten Elemente werden auch auf der Registerkarte "Links" angezeigt. Alle im Abschnitt "Entwicklung" gestarteten Entwicklungsmaßnahmen werden auch auf der Registerkarte "Verlauf" aufgezeichnet.

Registerkarte „Links“, Entwicklungslinks

Um ein Arbeitselement mit einem vorhandenen Objekt zu verknüpfen, wählen Sie das Link hinzufügen Symbol „Links hinzufügen“ und dann den Linktyp aus.

Symbol „Links hinzufügen“ und dann den Linktyp auswählen.

Wenn Sie einen Link entfernen möchten, können Sie dies im Abschnitt "Entwicklung" tun, indem Sie ihn zuerst hervorheben und dann "Link entfernen" auswählen.

Abschnitt „Entwicklung“, Link löschen

Alternativ können Sie sie auf der Registerkarte "Links" auswählen und "Aktionen" für den Link und dann die Option "Link entfernen" auswählen.

Zugeordnete Arbeitselemente im Build

Bei Git-Commits werden alle Arbeitselemente, die mit einem Commit verknüpft wurden, unter den zugeordneten Arbeitselementen auf der Buildzusammenfassungsseite aufgeführt.

Verknüpfte Arbeitselemente, die auf der Seite „Buildzusammenfassung“ unter „Zugeordnete Arbeitselemente“ aufgeführt sind.

In diesem Abschnitt angezeigte Links werden aufgrund dieser Aktionen angezeigt:

  • Erstellen eines Branchs, Commits oder Pull Requests aus dem Arbeitselement
  • Angeben der Arbeitselement-ID während eines Commits, Pull Requests oder eines anderen unterstützten Git- oder TFVC-Vorgangs
  • Verknüpfen Sie die Arbeitsaufgabe speziell über den Abschnitt "Entwicklung" oder "Verknüpfungen" mit einer Quellcodeverzweigung, einem Build oder einem anderen unterstützten Git- oder TFVC-Vorgang.

Wenn Sie mit dem Mauszeiger auf einen im Abschnitt „Entwicklung“ aufgeführten Eintrag zeigen, wird der Link zu dem zugeordneten Objekt aktiviert.

Die Linktypen, die Sie im Abschnitt „Entwicklung“ hinzufügen können, sind Branch, Build, Changeset, Commit, Im Build gefunden, In den Build integriert, Pull Request und Element mit Versionsangabe.

Artefakt-zu-Artefakt-Linktypen

Weitere Informationen zum Verknüpfungssteuerelement oder zum Anpassen des Steuerelements für Entwicklungslinks finden Sie unter LinksControlOptions-Elemente, Entwicklungslinks-Steuerelement.