Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).
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.
# Organisation Ihrer Quellcode-Arbeit mit Filialen in Amazon CodeCatalyst
In Git sind Branches Zeiger oder Verweise auf einen Commit. In der Entwicklung sind sie eine praktische Möglichkeit, die Arbeit zu organisieren. Du kannst Branches verwenden, um die Arbeit an einer neuen oder anderen Version von Dateien voneinander zu trennen, ohne die Arbeit in anderen Branches zu beeinträchtigen. Sie können Verzweigungen verwenden, um neue Funktionen zu entwickeln, eine bestimmte Version Ihres Projekts zu speichern und vieles mehr. Sie können Regeln für Branches in Quell-Repositorys konfigurieren, um bestimmte Aktionen in einem Branch auf bestimmte Rollen in diesem Projekt zu beschränken.
Quell-Repositorys in Amazon CodeCatalyst haben Inhalte und einen Standardzweig, unabhängig davon, wie Sie sie erstellen. Verknüpfte Repositorys haben möglicherweise keinen Standard-Branch oder Inhalt, sind aber CodeCatalyst erst nutzbar, wenn Sie sie initialisieren und einen Standard-Branch erstellen. Wenn Sie ein Projekt mithilfe eines Blueprints erstellen, CodeCatalyst wird ein Quell-Repository für dieses Projekt erstellt, das eine README.md-Datei, Beispielcode, Workflow-Definitionen und andere Ressourcen enthält. *Wenn Sie ein Quell-Repository erstellen, ohne einen Blueprint zu verwenden, wird als erster Commit eine README.md-Datei für Sie hinzugefügt, und ein Standardzweig wird für Sie erstellt.* *Dieser Standardzweig heißt main.* Dieser Standardzweig wird als Basis- oder Standardzweig in lokalen Repositorys (Repos) verwendet, wenn Benutzer das Repository klonen.
**Anmerkung**
Sie können den Standardzweig nicht löschen. Der erste Branch, der für ein Quell-Repository erstellt wurde, ist der Standard-Branch für dieses Repository. Darüber hinaus zeigt die Suche nur Ergebnisse aus dem Standardzweig an. Sie können in anderen Branchen nicht nach Code suchen.
Beim Erstellen eines Repositorys in wird CodeCatalyst auch ein erster Commit erstellt, der einen *Standard-Branch* mit einer darin enthaltenen README.md-Datei erstellt. *Der Name dieses Standardzweigs ist main.* Dies ist der Standard-Zweigname, der in den Beispielen in diesem Handbuch verwendet wird.
**Topics**
+ [Eine Filiale erstellen](source-create-delete-branch.md)
+ [Den Standard-Branch für ein Repository verwalten](source-branches-default-branch.md)
+ [Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten](source-branches-branch-rules.md)
+ [Git-Befehle für Branches](source-branches-git.md)
+ [Filialen und Details anzeigen](source-branches-view.md)
+ [Löschen eines Zweigs](source-branches-delete.md)
# Eine Filiale erstellen
Sie können die CodeCatalyst Konsole verwenden, um Branches in einem CodeCatalyst Repository zu erstellen. Die von Ihnen erstellten Branches sind für andere Benutzer sichtbar, wenn sie das nächste Mal Änderungen aus dem Repository abrufen.
**Tipp**
Sie können im Rahmen der Erstellung einer Entwicklungsumgebung auch Branches erstellen, um an Ihrem Code zu arbeiten. Weitere Informationen finden Sie unter [Erstellen einer Entwicklungsumgebung](devenvironment-create.md).
Du kannst Git auch verwenden, um Branches zu erstellen. Weitere Informationen finden Sie unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table).
**Um einen Zweig (Konsole) zu erstellen**
1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, in dem sich Ihr Quell-Repository befindet.
1. 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-Repositories** auswählen.
1. Wählen Sie das Repository aus, in dem Sie einen Branch erstellen möchten.
1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Mehr** und dann **Zweig erstellen** aus.
1. Geben Sie einen Namen für den Branch ein.
1. Wählen Sie einen Zweig aus, aus dem der Zweig erstellt werden soll, und klicken Sie dann auf **Erstellen**.
# Den Standard-Branch für ein Repository verwalten
Sie können angeben, welcher Branch als *Standard-Branch* in einem Quell-Repository in Amazon verwendet werden soll CodeCatalyst. Alle Quell-Repositorys in CodeCatalyst haben Inhalte und einen Standardzweig, unabhängig davon, wie Sie sie erstellen. *Wenn Sie einen Blueprint verwenden, um ein Projekt zu erstellen, heißt der Standardzweig im Quell-Repository, der für dieses Projekt erstellt wurde, main.* Der Inhalt des Standardzweigs wird automatisch auf der Übersichtsseite für dieses Repository angezeigt.
**Wichtig**
CodeCatalyst unterstützt nicht die Erkennung von Änderungen im Standard-Branch für verknüpfte Repositorys. Um den Standardzweig für ein verknüpftes Repository zu ändern, müssen Sie zuerst die Verknüpfung mit dem Repository CodeCatalyst aufheben, den Standardzweig ändern und ihn dann erneut verknüpfen. Weitere Informationen finden Sie unter [Verknüpfen von GitHub Repositorys, Bitbucket-Repositorys, GitLab Projekt-Repositorys und Jira-Projekten in CodeCatalyst](extensions-link.md).
Als bewährte Methode sollten Sie immer sicherstellen, dass Sie über die neueste Version der Erweiterung verfügen, bevor Sie ein Repository verknüpfen.
Der Standard-Branch wird etwas anders behandelt als alle anderen Branches in einem Quell-Repository. Neben seinem Namen steht ein spezielles Label, **Default**. Der Standard-Branch wird als Basis- oder Standard-Branch in lokalen Repositorys (Repos) verwendet, wenn Benutzer das Repository mit einem Git-Client auf lokale Computer klonen. Er ist auch der Standard, der bei der Erstellung von Workflows zum Speichern von Workflow-YAML-Dateien und zum Speichern von Informationen für Probleme verwendet wird. Wenn Sie „Suchen in“ verwenden CodeCatalyst, wird nur der Standardzweig eines Repositorys durchsucht. Da der Standardzweig für so viele Aspekte von Projekten von grundlegender Bedeutung ist, können Sie einen Branch nicht löschen, wenn er als Standard-Branch angegeben ist. Sie können sich jedoch dafür entscheiden, einen anderen Zweig als Standardzweig zu verwenden. Wenn Sie dies tun, werden alle [Zweigregeln](source-branches-branch-rules.md), die auf den früheren Standardzweig angewendet wurden, automatisch auf den Zweig angewendet, den Sie als Standardzweig angeben.
**Anmerkung**
Sie benötigen die Rolle eines Projektadministrators, um den Standardzweig für Quell-Repositorys in CodeCatalyst Projekten ändern zu können. Dies gilt nicht für verknüpfte Repositorys.
**Um den Standard-Branch für ein Repository anzuzeigen und zu ändern**
1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet.
1. 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-Repositories** auswählen.
Wählen Sie das Repository aus, in dem Sie die Einstellungen, einschließlich des Standardzweigs, anzeigen möchten.
1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Mehr** und anschließend **Einstellungen verwalten** aus.
1. Im **Standardzweig** wird der Name des als Standardverzweigung angegebenen Zweigs zusammen mit der Bezeichnung **Standard** neben dem Namen angezeigt. Dieselbe Bezeichnung wird neben dem Zweignamen in der Liste der Zweige unter **Zweige** angezeigt.
1. Um den Standardzweig zu ändern, wählen Sie **Bearbeiten**.
**Anmerkung**
Sie müssen im Projekt über die Rolle des Projektadministrators verfügen, um den Standardzweig ändern zu können.
1. Wählen Sie aus der Dropdownliste den Namen des Zweigs aus, den Sie zum Standardzweig machen möchten, und wählen Sie dann **Speichern** aus.
# Zulässige Aktionen für einen Branch mit Branch-Regeln verwalten
Wenn Sie einen Branch erstellen, sind je nach den Berechtigungen für diese Rolle bestimmte Aktionen für diesen Branch zulässig. Sie können ändern, welche Aktionen für einen bestimmten Zweig zulässig sind, indem Sie Zweigregeln konfigurieren. Branch-Regeln basieren auf der Rolle, die ein Benutzer in Ihrem Projekt innehat. Sie können sich dafür entscheiden, einige vordefinierte Aktionen, wie das Übertragen von Commits an einen Branch, auf Benutzer mit einer bestimmten Rolle in einem Projekt zu beschränken. Auf diese Weise können Sie bestimmte Branches in einem Projekt schützen, indem Sie einschränken, welche Rollen bestimmte Aktionen ausführen dürfen. Wenn Sie beispielsweise eine Verzweigungsregel so konfigurieren, dass nur Benutzer mit der Rolle des **Projektadministrators** diesen Zweig zusammenführen oder zu diesem Zweig wechseln können, können Benutzer mit anderen Rollen im Projekt keine Änderungen am Code in diesem Zweig vornehmen.
Sie sollten alle Auswirkungen der Erstellung einer Regel für einen Zweig sorgfältig abwägen. Wenn Sie sich beispielsweise dafür entscheiden, Pushs auf einen Branch auf Benutzer mit der Rolle **Project Administrator** zu beschränken, können Benutzer mit der Rolle **Contributor** keine Workflows in diesem Branch erstellen oder bearbeiten, da das Workflow-YAML in diesem Branch gespeichert ist und diese Benutzer keine Änderungen an der YAML festschreiben und per Push ü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. Sie können 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 einer Pull-Anfrage mit Genehmigungsregeln](source-pull-requests-approval-rules.md).
**Anmerkung**
Sie benötigen die Rolle eines Projektadministrators, 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 Verzweigungsregeln 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 Rolle Reviewer ermöglicht, Push in den Branch zu übertragen.
Branch-Regeln, die auf den Standard-Branch Ihres 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 Sie als Standard-Branch angeben. Der Zweig, der zuvor als Standardzweig festgelegt wurde, behält weiterhin die Regeln bei, die auf ihn angewendet wurden, mit der Ausnahme, dass er nicht mehr vor dem Löschen geschützt ist. Dieser Schutz wird nur auf den aktuellen Standardzweig angewendet.
Zweigregeln haben zwei Status: **Standard** und **Benutzerdefiniert**. **Standard** gibt an, dass die in einem Branch zulässigen Aktionen den Berechtigungen entsprechen, die der Benutzer für Branch-Aktionen in CodeCatalyst der Rolle hat, über die der Benutzer verfügt. Weitere Informationen darüber, welche Rollen welche Berechtigungen haben, finden Sie unter[Zugriff mit Benutzerrollen gewähren](ipa-roles.md). **Benutzerdefiniert** gibt an, dass eine oder mehrere Branch-Aktionen Aktionen mit einer bestimmten Liste von Rollen haben, die diese Aktion ausführen dürfen. Diese Liste unterscheidet sich von den Standardberechtigungen, die durch die Rolle eines Benutzers im Projekt gewährt werden.
**Anmerkung**
Wenn Sie eine Verzweigungsregel erstellen, um eine oder mehrere Aktionen für einen Zweig einzuschränken, wird **die Aktion Verzweigung löschen** automatisch so eingestellt, dass nur Benutzer mit der Projektadministratorrolle diesen Zweig löschen können.
In der folgenden Tabelle sind die Aktionen und die Standardeinstellungen für Rollen aufgeführt, die diese Aktionen in einem Zweig ausführen dürfen.
**Aktionen und Rollen in Zweigen**
| **Maßnahmen in der Branche** | Rollen, die diese Aktion ausführen dürfen, wenn keine Branch-Regeln angewendet werden |
| --- | --- |
| Mit dem Branch zusammenführen (dazu gehört auch das Zusammenführen einer Pull-Anfrage mit dem Branch) | Projektadministrator, Mitwirkender |
| Gehen 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 so aktualisieren, dass Aktionen von allen Rollen zugelassen werden, die diese Aktion in einem Branch ausführen dürfen, wodurch die Regel effektiv entfernt wird.
**Anmerkung**
Sie benötigen die Rolle eines Projektadministrators, um Verzweigungsregeln 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 anzuzeigen und zu bearbeiten**
1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet.
1. 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.
1. Wählen Sie auf der Übersichtsseite des Repositorys die Option **Branches** aus.
1. Sehen Sie sich in der Spalte **Branch-Regeln** den Status der Regeln für jeden Branch des Repositorys an. **Standard** gibt an, dass die Regeln für Branch-Aktionen die Standardregeln für alle Branches sind, die in einem Quell-Repository erstellt wurden, und dass sie den Berechtigungen entsprechen, die diesen Rollen in einem Projekt gewährt 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 beschränken.
Um die Einzelheiten der Branch-Regeln für einen Branch einzusehen, wählen Sie neben dem Zweig, den Sie überprüfen möchten, das Wort **Standard** oder **Benutzerdefiniert** aus.
1. Um eine Zweigregel zu erstellen oder zu ändern, wählen Sie **Einstellungen verwalten**. Wählen Sie auf der Einstellungsseite für das Quell-Repository unter **Branch-Regeln die** Option **Bearbeiten** aus.
1. 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 aus der Dropdownliste die Rollen aus, denen Sie die Aktion zuweisen möchten, und wählen Sie dann **Speichern** aus.
# Git-Befehle für Branches
Du kannst Git verwenden, um Branches im Clone des Quell-Repositorys, das du auf deinem Computer (deinem lokalen Repo) oder in deinen Entwicklungsumgebungen hast, zu erstellen, zu verwalten und zu löschen. Anschließend kannst du deine Änderungen in dein CodeCatalyst Quell-Repository (das Remote-Repository) übertragen und per Push übertragen. Beispiel:
**Allgemeine Git-Befehle für Branches**
| | |
| --- |--- |
| Listet alle Branches im lokalen Repository auf, wobei neben deinem aktuellen Branch ein Sternchen (`*`) angezeigt wird. | `git branch` |
| Ruft Informationen über alle vorhandenen Branches im Remote-Repository in das lokale Repository ab. | `git fetch` |
| Listet alle Branches im lokalen Repo und alle Remote-Tracking-Zweige im lokalen Repo auf. | `git branch -a` |
| Listet nur Remote-Tracking-Zweige im lokalen Repo auf. | `git branch -r` |
| Erstellt einen Zweig im lokalen Repository unter Verwendung des angegebenen Zweignamens. Dieser Branch wird erst im Remote-Repository angezeigt, wenn Sie die Änderung festschreiben und übertragen. | `git branch branch-name` |
| Erstellt einen Branch im lokalen Repository unter Verwendung des angegebenen Branch-Namens und wechselt dann zu diesem. | `git checkout -b branch-name` |
| Wechselt unter Verwendung des angegebenen Zweignamens zu einem anderen Zweig im lokalen Repository. | `git checkout other-branch-name` |
| Verschiebt einen Branch vom lokalen Repository zum Remote-Repository und verwendet dabei den im lokalen Repository angegebenen Spitznamen für das Remote-Repository und den angegebenen Branch-Namen. Richtet außerdem Upstream-Tracking-Informationen für den Branch im lokalen Repository ein. | `git push -u remote-name branch-name` |
| Führt Änderungen von einem anderen Zweig im lokalen Repository mit dem aktuellen Zweig im lokalen Repository zusammen. | `git merge from-other-branch-name` |
| Löscht einen Zweig im lokalen Repository, es sei denn, er enthält Werke, die noch nicht zusammengeführt wurden. | `git branch -d branch-name` |
| Löscht einen Branch im Remote-Repository mit dem angegebenen Spitznamen, den das lokale Repository für das Remote-Repository hat, und dem angegebenen Branch-Namen. (Beachten Sie die Verwendung des Doppelpunkts (`:`).) Sie können dies auch `--delete` als Teil des Befehls angeben. | `git push remote-name :branch-name` `git push remote-name --delete branch-name` |
Weitere Informationen findest du in deiner Git-Dokumentation.
# Filialen und Details anzeigen
In der CodeCatalyst Amazon-Konsole können Sie Informationen zu Remote-Branches in Amazon einsehen CodeCatalyst, einschließlich Einzelheiten zu den Dateien, Ordnern und dem letzten Commit für eine bestimmte Filiale. Sie können auch Git-Befehle und Ihr lokales Betriebssystem verwenden, um diese Informationen für entfernte und lokale Niederlassungen anzuzeigen.
**Um Branches anzuzeigen (Konsole)**
1. Navigieren Sie in der CodeCatalyst Konsole zu dem Projekt, das das Quell-Repository enthält, in dem Sie die Branches anzeigen möchten. Wählen Sie **Code**, dann **Quell-Repositories** und anschließend das Quell-Repository aus.
1. 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-Repositories** auswählen.
Wählen Sie das Repository aus, in dem Sie einen Branch anzeigen möchten.
1. Der Standardzweig des Repositorys wird angezeigt. Sie können eine Liste der Dateien und Ordner im Branch, Informationen über den letzten Commit und den Inhalt der README.md-Datei, falls sie im Branch vorhanden ist, sehen. Um die Informationen für einen anderen Branch anzuzeigen, wählen Sie ihn aus der Dropdownliste der Branches für das Repository aus.
1. Um alle Branches für ein Repository anzuzeigen, wählen Sie **Alle anzeigen**. Auf der Seite „Branches“ werden Informationen zum Namen, zum letzten Commit und zu den Regeln für jeden Branch angezeigt.
Informationen dazu, wie du Git und dein Betriebssystem zum Anzeigen von Branches und Details verwendest, findest du unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table), in deiner Git-Dokumentation und in deiner Betriebssystemdokumentation.
# Löschen eines Zweigs
Wenn Sie einen Branch nicht mehr benötigen, können Sie ihn löschen. Wenn Sie beispielsweise einen Branch mit einer Feature-Änderung mit dem Standard-Branch zusammengeführt haben und dieses Feature veröffentlicht wurde, möchten Sie vielleicht den ursprünglichen Feature-Branch löschen, da die Änderungen bereits Teil des Standard-Branches sind. Wenn Sie die Anzahl der Zweige gering halten, können Benutzer den Zweig leichter finden, der die Änderungen enthält, an denen sie arbeiten möchten. Wenn Sie einen Zweig löschen, verbleiben Kopien dieses Zweigs in den Klonen des Repositorys auf lokalen Computern, bis Benutzer diese Änderungen abrufen und synchronisieren.
**Um einen Branch zu löschen (Konsole)**
1. Navigieren Sie zu dem Projekt, in dem sich Ihr Repository befindet.
1. 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 einen Branch löschen möchten.
1. Wählen Sie auf der Übersichtsseite des Repositorys die Dropdownauswahl neben dem Branch-Namen und wählen Sie dann **Alle anzeigen** aus.
1. Wählen Sie den Zweig aus, den Sie löschen möchten, und klicken Sie dann auf **Zweig löschen**.
**Anmerkung**
Sie können den Standardzweig für ein Repository nicht löschen.
1. Ein Bestätigungsdialogfeld wird angezeigt. Es zeigt das Repository, die Anzahl der geöffneten Pull-Requests und die Anzahl der Workflows, die dem Branch zugeordnet sind.
1. Um das Löschen des Branches zu bestätigen, geben **Sie Löschen** in das Textfeld ein und wählen Sie dann **Löschen** aus.
Du kannst Git auch verwenden, um Branches zu löschen. Weitere Informationen finden Sie unter [Allgemeine Git-Befehle für Branches](source-branches-git.md#source-branches-git-table).