Genehmigungsregeln für Pull Requests hinzufügen

Geschrieben für die alte Benutzeroberfläche

Dieser Artikel wurde für die alte Benutzeroberfläche geschrieben. Die Anweisungen sind weiterhin verwendbar, aber die Screenshots sind veraltet. In einigen Fällen wurden die in den Anweisungen genannten Elemente verschoben oder geändert. Wenn Sie ein Element nicht finden können, siehe den Wo ist es hin Artikel.

Übersicht

Dieser Artikel erklärt, wie eine Pull-Request-Genehmigungsregel funktioniert und wie man sie hinzufügt. Standardmäßig erfordert ein Pull Request keine Überprüfungen, bevor er zusammengeführt werden kann. Mit einer Pull-Request-Genehmigungsregel können Administratoren eine Mindestanzahl an Genehmigungen erzwingen, bevor ein Pull Request zusammengeführt werden kann. Jede Regel definiert, für welche Branches sie gilt und wie viele Genehmigungen erforderlich sind. Der Ziel-Branch eines Pull Requests bestimmt, wie viele Genehmigungen erforderlich sind.

Die Regel kann mit unterschiedlichen Geltungsbereichen konfiguriert werden:

• Alle Branches: Die Regel gilt für jeden Branch, der nicht von einer spezifischeren Regel abgedeckt wird.
• Auswählen: Die Regel gilt für einen oder mehrere ausdrücklich ausgewählte Branches.
• Muster: Die Regel verwendet Platzhalter-Syntax, um Branches anhand der Namenskonvention abzugleichen (z. B. feature/*, release/v*, hotfix-*).

Pull-Request-Genehmigungsregel außer Kraft setzen

Eine Pull-Request-Genehmigungsregel kann nicht außer Kraft gesetzt werden. Wenn die Regel für den Ziel-Branch gilt, kann der Pull Request erst zusammengeführt werden, wenn die erforderliche Anzahl an Prüfern ihn genehmigt hat. Diese Durchsetzung ist beabsichtigt. Es gibt jedoch zwei genehmigte Möglichkeiten, eine Pull-Request-Genehmigungsregel zu umgehen:

• Führen Sie eine Smart Merge, die keine Überprüfung erfordert.
• Ändern Sie die Pull-Request-Genehmigungsregel.

Pull-Request-Beispiel

Der folgende Screenshot zeigt einen Pull Request mit einer angewendeten Genehmigungsregel.

Regelhierarchie

Wenn sich die ausgewählten Branches einer Regel mit denen einer anderen Regel überschneiden, bestimmt die Priorität, welche Regel für den überschneidenden Branch gilt. Die Reihenfolge der Priorität von hoch nach niedrig lautet:

• Auswählen > Muster > Alle Branches

Der folgende Screenshot zeigt zwei Regeln: Eine gilt für Alle Branches, und die andere gilt nur für den main Branch. Da die Auswählen Regel Vorrang vor der Alle Branches Regel hat, erfordern alle Pull Requests, die auf den main Branch abzielen, 3 Genehmigungen statt der 1 Genehmigung, die für andere Branches erforderlich ist.

Randfälle

Die Auswählen Die Option erlaubt es nicht, denselben Branch mehr als einer Regel zuzuweisen. Dadurch werden Konflikte verhindert, wie etwa dass eine Regel drei Genehmigungen für Branch X erfordert, während eine andere nur eine erfordert.

Die Muster Die Option erlaubt es nicht, mehrere Regeln mit überlappenden Mustern zu speichern. Zum Beispiel können Sie nicht sowohl feature/* und feature/new*, weil das feature/* Muster bereits das feature/new* Muster enthält.

Genehmigungsregeln hinzufügen

1

Genehmigungsregeln aktivieren

1. Klicken Sie Einstellungen im linken Seitenleistenmenü.
2. Klicken Sie auf das Allgemein Tab angezeigt.
3. Klicken Sie Pull Requests.

   
4. Wenn deaktiviert, klicken Sie auf den Aktivieren Schalter, um Genehmigungsregeln zu aktivieren.

   

2

Branches auswählen

Es gibt drei Methoden, um auszuwählen, auf welche Branches die Genehmigungsregel angewendet wird.

Alle Branches

Diese Auswahl wendet die Regel auf jeden Branch in Ihrem DevOps-Mandanten an.

1. Wählen Sie den Alle Branches Option.

Auswählen

Diese Auswahl wendet die Regel nur auf die Branches an, die Sie aus der Liste auswählen.

1. Wählen Sie den Auswählen Option.
2. Klicken Sie auf das Branches auswählen Dropdown-Menü.
3. Wählen Sie jeden der Branches aus, auf den diese Regel angewendet werden soll.

   

Bei jedem ausgewählten Branch wird rechts ein Häkchen angezeigt. Die Dropdownliste zeigt außerdem die Anzahl der ausgewählten und verfügbaren Branches an. Wenn Sie viele Branches haben, verwenden Sie das Suchfeld, um sie zu finden.

Muster

Diese Auswahl wendet die Regel auf alle Branches an, die dem von Ihnen eingegebenen Muster entsprechen. Sie können das Platzhalterzeichen (*) am Ende eines Musters hinzufügen, um Branches abzugleichen, die mit Ihrem Muster beginnen und mit beliebigen anderen Zeichen enden. Wenn Sie beispielsweise das Muster verwenden feature/*, zeigt die folgende Tabelle, wie sich diese Regel auf Ihre Branches auswirkt.

Branches	Regel angewendet
main
feature/addAccount
feature/removeAccount
release/v1.2.3

1. Wählen Sie den Muster Option.
2. Geben Sie das Muster ein, das für diese Regel im Textfeld verwendet werden soll.

   

3

Genehmigungsanzahl festlegen

Die Genehmigungsanzahl ist die Anzahl der Prüfer, die einen Pull Request genehmigen müssen, bevor er zusammengeführt werden kann. Die Anzahl muss mindestens 1 betragen.

1. Geben Sie die für diese Regel erforderliche Anzahl an Genehmigungen in der Genehmigungsanzahl Textfeld ein.

   

4

Regeln hinzufügen

Sie können den Pull-Request-Einstellungen mehrere Genehmigungsregeln hinzufügen. Um zu erfahren, welche Regel für einen Branch gilt, der von mehreren Regeln ausgewählt wird, siehe den Regelhierarchie Abschnitt oben.

1. Klicken Sie Regel hinzufügen.

   
2. Konfigurieren Sie die Branch-Auswahl und die Genehmigungsanzahl der Regel anhand der obigen Anweisungen.

   

5

Regeln speichern

Sobald Sie das Definieren Ihrer Pull-Request-Genehmigungsregeln abgeschlossen haben, müssen Sie sie speichern, bevor sie auf neue und aktive Pull Requests angewendet werden.

1. Klicken Sie Speichern.