Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Verzweigungsrichtlinien sind ein leistungsfähiges Feature, um hochwertigen Code in Ihrem Repository sicherzustellen, indem Anforderungen für alle Pullanforderungen festgelegt werden. Externe Dienste können die PR-Status-API verwenden, um detaillierten Status für Ihre PRs zu veröffentlichen. Die Zweigrichtlinie für externe Dienste bietet die Möglichkeit, dass diese Drittanbieterdienste am PR-Workflow teilnehmen und Richtlinienanforderungen festlegen können. Dieser Artikel führt Sie durch den Prozess der Konfiguration einer Verzweigungsrichtlinie für einen Dienst, der den PR-Status veröffentlicht. Weitere Informationen zum PR-Status finden Sie unter Anpassen und Erweitern von Pullanforderungsworkflows mit Pullanforderungsstatus.
Voraussetzungen
| Kategorie | Anforderungen |
|---|---|
| Projektzugriff | Mitglied eines Projekts. |
| Erlaubnisse | - Code in privaten Projekten anzeigen: Mindestens einfacher Zugriff. - Klonen oder Mitwirken an Code in privaten Projekten: Mitglied der Sicherheitsgruppe "Mitwirkende" oder entsprechende Berechtigungen im Projekt. – Legen Sie Verzweigungs- oder Repositoryberechtigungen fest: Berechtigungen für die Verzweigung oder das Repository verwalten . - Standardverzweigung ändern: Bearbeiten von Richtlinienberechtigungen für das Repository. - Importieren eines Repositorys: Mitglied der Sicherheitsgruppe "Projektadministratoren " oder "Git-Projektebene Repository erstellen"-Berechtigungssatz auf "Zulassen". Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen. |
| Dienste | Repos aktiviert. |
| Werkzeuge | Wahlfrei. Verwenden Sie az repos-Befehle : Azure DevOps CLI. |
Hinweis
In öffentlichen Projekten haben Benutzer mit Stakeholder-Zugriff vollzugriff auf Azure Repos, einschließlich Anzeigen, Klonen und Beitragen zu Code.
| Kategorie | Anforderungen |
|---|---|
| Projektzugriff | Mitglied eines Projekts. |
| Erlaubnisse | - Code anzeigen: Mindestens einfacher Zugriff. - Klonen oder Zum Code beitragen: Mitglied der Sicherheitsgruppe "Mitwirkende " oder entsprechende Berechtigungen im Projekt. |
| Dienste | Repos aktiviert. |
Konfigurieren der Verzweigungsrichtlinie
Navigieren Sie zu Code>Branches , und suchen Sie die Verzweigung, für die Sie die Richtlinie konfigurieren möchten (in der Regel
mainoderdevelop). Wählen Sie im Kontextmenü die Option "Verzweigungsrichtlinien " aus.
Scrollen Sie nach unten, um Statusprüfungen zu finden. Wählen Sie die + Schaltfläche aus.
Wählen Sie den Dienst aus, für den Sie eine Richtlinie aus der Liste erstellen möchten. Wenn der Status zuvor veröffentlicht wurde, können Sie ihn aus der Liste auswählen. wenn es sich um eine neue Richtlinie handelt, können Sie den Namen der Richtlinie eingeben.
- Die Richtlinienanforderung bestimmt, ob diese Richtlinie optional oder erforderlich ist, um Pullanforderungen in die Verzweigung abzuschließen.
- Die autorisierte Identität wird verwendet, um diesen Status nur aus der angegebenen Identität zu erzwingen, wird auf die Richtlinienerfüllung gezählt.
- Zurücksetzungsbedingungen werden verwendet, um zu bestimmen, wann ein gebuchter Status nicht mehr gültig ist. Wenn der bereitgestellte Status spezifisch für den neuesten Code ist (d. h. ein Build), überprüfen Sie den Status zurücksetzen, wenn neue Änderungen vorhanden sind , um den Status zurückzusetzen, wenn sich der Quellzweig ändert.
- Optional einen Pfadfilter festlegen. Weitere Informationen zu Pfadfiltern in Verzweigungsrichtlinien.
- Die Anwendbarkeit der Richtlinie bestimmt, ob diese Richtlinie gilt, sobald eine Pullanforderung erstellt wird, oder ob die Richtlinie nur angewendet wird, nachdem der erste Status an die Pullanforderung gesendet wurde.
- Mit dem Standardanzeigenamen können Sie einen optionalen Anzeigenamen für Ihre Richtlinie angeben.
Erstellen einer neuen Pullanforderung
Erstellen Sie eine neue Pullanforderung in der Verzweigung, in der die Richtlinie definiert ist. Weitere Informationen finden Sie unter Erstellen einer Pullanforderung.
Nach dem Erstellen der PR wird die neue Richtlinie im Abschnitt "Richtlinien" der Ansicht "PR-Details" angezeigt. Zunächst wird die Richtlinie als nicht festgelegt angezeigt, bis der externe Dienst den Status gebucht hat.
Wenn der Dienst den Status gepostet hat, wird die Richtlinie entsprechend aktualisiert. Der Abschluss wird blockiert, bis die Richtlinie die PR genehmigt.
Wenn die Richtlinienkriterien erfüllt sind und der Dienst einen
succeededStatus sendet, wird die PR genehmigt und der Abschluss wird aufgehoben.
Zusammenfassung
In diesem Artikel haben Sie erfahren, wie Sie eine Verzweigungsrichtlinie für einen externen Dienst konfigurieren.