View a markdown version of this page

Erlaubte Aktionen für einen Branch mit Branch-Regeln verwalten - Amazon CodeCatalyst

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erlaubte Aktionen für einen Branch mit Branch-Regeln verwalten

Wenn du einen Branch erstellst, sind für diesen Branch je nach den Berechtigungen für diese Rolle bestimmte Aktionen zulässig. Sie können ändern, welche Aktionen für einen bestimmten Branch zulässig sind, indem Sie Branch-Regeln konfigurieren. Branch-Regeln basieren auf der Rolle, die ein Benutzer in Ihrem Projekt hat. Du kannst dich dafür entscheiden, einige vordefinierte Aktionen, wie das Senden von Commits an einen Branch, auf Benutzer mit einer bestimmten Rolle in einem Projekt zu beschränken. Das kann dir helfen, bestimmte Branches in einem Projekt zu schützen, indem du einschränkst, welche Rollen bestimmte Aktionen ausführen dürfen. Wenn Sie beispielsweise eine Branch-Regel so konfigurieren, dass nur Benutzer mit der Rolle Projektadministrator diesen Branch zusammenführen oder zu diesem Branch übertragen können, können Benutzer mit anderen Rollen im Projekt keine Änderungen am Code in diesem Branch vornehmen.

Sie sollten alle Auswirkungen, die das Erstellen einer Regel für einen Zweig mit sich bringt, sorgfältig abwägen. Wenn Sie sich beispielsweise dafür entscheiden, Pushs an einen Branch auf Benutzer mit der Rolle Projektadministrator zu beschränken, können Benutzer mit der Rolle Mitwirkender keine Workflows in diesem Branch erstellen oder bearbeiten, da die Workflow-YAML in diesem Branch gespeichert ist und diese Benutzer keine Änderungen an die YAML übertragen und übertragen können. Es hat sich bewährt, alle Branch-Regeln zu testen, nachdem Sie sie erstellt haben, um sicherzustellen, dass sie keine Auswirkungen haben, die Sie nicht beabsichtigt haben. Du kannst Branch-Regeln auch in Verbindung mit Genehmigungsregeln für Pull Requests verwenden. Weitere Informationen finden Sie unter Verwaltung der Anforderungen für das Zusammenführen eines Pull Requests mit Genehmigungsregeln.

Anmerkung

Du musst über die Rolle Projektadministrator verfügen, um Branch-Regeln für Quell-Repositorys in CodeCatalyst Projekten verwalten zu können. Sie können keine Branch-Regeln für verknüpfte Repositorys erstellen.

Sie können nur Branch-Regeln erstellen, die restriktiver sind als die Standardberechtigungen für die Rolle. Sie können keine Branch-Regeln erstellen, die freizügiger sind, als es die Rolle eines Benutzers im Projekt zulässt. Sie können beispielsweise keine Branch-Regel erstellen, die es Benutzern mit der Reviewer-Rolle ermöglicht, zum Branch zu wechseln.

Branch-Regeln, die auf den Standard-Branch deines Quell-Repositorys angewendet werden, verhalten sich etwas anders als Branch-Regeln, die auf andere Branches angewendet werden. Jede Regel, die auf den Standard-Branch angewendet wird, wird automatisch auf jeden Branch angewendet, den du als Standard-Branch angegeben hast. Der Branch, der zuvor als Standard-Branch festgelegt wurde, behält weiterhin die auf ihn angewendeten Regeln bei, außer dass er nicht mehr vor dem Löschen geschützt ist. Dieser Schutz wird nur auf den aktuellen Standard-Branch angewendet.

Branch-Regeln haben zwei Status: Standard und Benutzerdefiniert. Standard gibt an, dass für einen Branch die Aktionen zulässig sind, die den Berechtigungen für die Rolle entsprechen, die der Benutzer CodeCatalyst für Branch-Aktionen innehat. Weitere Informationen darüber, welche Rollen welche Berechtigungen haben, finden Sie unterZugriff mit Benutzerrollen gewähren. Benutzerdefiniert gibt an, dass eine oder mehrere Branch-Aktionen Aktionen enthalten, die über eine bestimmte Liste von Rollen verfügen, die diese Aktion ausführen dürfen und die sich von den Standardberechtigungen unterscheiden, die durch die Rolle eines Benutzers im Projekt gewährt wurden.

Anmerkung

Wenn Sie eine Branch-Regel erstellen, um eine oder mehrere Aktionen für einen Branch einzuschränken, wird die Aktion Branch löschen automatisch so gesetzt, dass nur Benutzer mit der Projektadministratorrolle diesen Branch löschen können.

In der folgenden Tabelle sind die Aktionen und die Standardeinstellungen für Rollen aufgeführt, die diese Aktionen in einem Branch ausführen dürfen.

Aktionen und Rollen in einem Branch
Aktion in der Filiale

Rollen dürfen diese Aktion ausführen, wenn keine Branch-Regeln angewendet werden

Zum Branch zusammenführen (dazu gehört auch das Zusammenführen eines Pull-Requests mit dem Branch)

Projektadministrator, Mitwirkender

Drücken Sie zur Filiale

Projektadministrator, Mitwirkender

Löschen Sie den Zweig

Projektadministrator, Mitwirkender

Löschen Sie den Zweig (Standardzweig)

Nicht zulässig

Sie können Branch-Regeln nicht löschen, aber Sie können sie aktualisieren, um Aktionen von allen Rollen zuzulassen, die diese Aktion für einen Branch ausführen dürften, wodurch die Regel effektiv entfernt wird.

Anmerkung

Sie müssen über die Rolle Projektadministrator verfügen, um Branch-Regeln für Quell-Repositorys in CodeCatalyst Projekten konfigurieren zu können. Dies gilt nicht für verknüpfte Repositorys. Verknüpfte Repositorys unterstützen die Branch-Regeln in nicht. CodeCatalyst

Um Branch-Regeln für ein Repository einzusehen und zu bearbeiten
  1. Navigiere zu dem Projekt, in dem sich dein Repository befindet.

  2. Wählen Sie den Namen des Repositorys aus der Liste der Quell-Repositorys für das Projekt aus. Sie können auch im Navigationsbereich Code und dann Quell-Repositorys auswählen.

    Wählen Sie das Repository aus, in dem Sie Branch-Regeln anzeigen möchten.

  3. Wählen Sie auf der Übersichtsseite des Repositorys Branches aus.

  4. Sehen Sie sich in der Spalte Branch-Regeln den Status der Regeln für jeden Zweig des Repositorys an. Standard gibt an, dass die Regeln für Branch-Aktionen die Standardregeln für jeden Branch sind, der in einem Quell-Repository erstellt wurde. Sie entsprechen den Berechtigungen, die diesen Rollen in einem Projekt erteilt wurden. Benutzerdefiniert gibt an, dass für eine oder mehrere Branch-Aktionen Regeln gelten, die eine oder mehrere Aktionen, die für diesen Branch zulässig sind, auf eine andere Gruppe von Rollen einschränken.

    Um die Einzelheiten der Branch-Regeln für einen Branch anzuzeigen, wählen Sie neben dem Branch, den Sie überprüfen möchten, das Wort Standard oder Benutzerdefiniert aus.

  5. Um eine Branch-Regel zu erstellen oder zu ändern, wähle Einstellungen verwalten aus. Wählen Sie auf der Einstellungsseite für das Quell-Repository unter Branch-Regeln die Option Bearbeiten aus.

  6. Wählen Sie unter Branch den Namen des Branches, für den Sie eine Regel konfigurieren möchten, aus der Dropdownliste aus. Wählen Sie für jeden der zulässigen Aktionstypen in der Dropdownliste die Rollen aus, denen Sie die Ausführung dieser Aktion gewähren möchten, und klicken Sie dann auf Speichern.