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
Tipp
Sie können KI verwenden, um Azure DevOps-Aufgaben zu unterstützen. Informationen zu den ersten Schritten finden Sie unter Enable AI-Unterstützung bei Azure DevOps MCP Server.
Branchrichtlinien sind ein leistungsstarkes Feature, um qualitativ hochwertigen Code in Ihrem Repository sicherzustellen, indem Anforderungen für alle Pull Requests 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 zum Konfigurieren einer Branchrichtlinie für einen Dienst, der PR-Status postet. Weitere Informationen zu PR-Status finden Sie unter Anpassen und Erweitern von Pull Request-Workflows mit Pull Request-Status.
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. - Berechtigungen für Branch oder Repository festlegen: Berechtigungen verwalten für den Branch oder das Repository. - Verzweigungsrichtlinien festlegen, Statusprüfungen konfigurieren oder die Standardverzweigung ändern: Berechtigung Richtlinien bearbeiten für das Repository oder die Verzweigung oder Mitgliedschaft in der Sicherheitsgruppe Projektadministratoren. - Ein Repository importieren: Mitglied der Sicherheitsgruppe Projektadministratoren oder die Berechtigung Repository erstellen auf Git-Projektebene auf Zulassen festgelegt. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen. |
| Dienste | Repos aktiviert. |
| Werkzeuge | Wahlfrei. Verwenden Sie az repos Befehle: Azure DevOps CLI. |
| Kategorie | Anforderungen |
|---|---|
| Projektzugriff | Mitglied eines Projekts. |
| Erlaubnisse | - Code anzeigen: Mindestens einfacher Zugriff. - Code klonen oder dazu beitragen: Mitglied der Sicherheitsgruppe Contributors oder entsprechende Berechtigungen im Projekt. |
| Dienste | Repos aktiviert. |
Konfigurieren der Branchrichtlinie
Navigieren Sie zu Code>Branches und suchen Sie den Branch, für den 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.
- Richtlinienanforderung bestimmt, ob diese Richtlinie optional oder erforderlich ist, um Pull-Anforderungen in den -Branch abzuschließen.
- Die autorisierte Identität wird verwendet, um sicherzustellen, dass nur der Status der angegebenen Identität auf die Erfüllung der Richtlinie angerechnet wird.
- Bedingungen zurücksetzen wird verwendet, um festzustellen, wann ein gebuchter Status nicht mehr gültig ist. Wenn der gepostete Status spezifisch für den neuesten Code (d. h. einen Build) ist, aktivieren Sie Status bei neuen Änderungen immer zurücksetzen, um den Status zurückzusetzen, wenn sich der Quellbranch ändert.
- Optional einen Pfadfilter festlegen. Weitere Informationen zu Pfadfiltern in Zweigrichtlinien.
- 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 einen neuen Pull-Request in dem Branch, in dem 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 übermittelt hat.
Wenn der Dienst den Status gepostet hat, wird die Richtlinie entsprechend aktualisiert. Der Abschluss wird blockiert, bis die Richtlinie den PR genehmigt.
Wenn die Richtlinienkriterien erfüllt sind und der Dienst einen
succeeded-Status postet, wird der PR genehmigt, und die Blockierung des Abschlusses wird aufgehoben.
Zusammenfassung
In diesem Artikel haben Sie erfahren, wie Sie eine Branch-Policy für einen externen Dienst konfigurieren.