Test – Informationen zu Branches – Test

Testen der Veröffentlichung 16.12.12

Verwenden Sie einen Branch, um Entwicklungsarbeit zu isolieren, ohne dass sich dies auf andere Branches im Repository auswirkt. Jedes Repository verfügt über eine Standardbranch und kann mehrere weitere Branches haben. Sie können einen Branch mithilfe eines Pull Requests in einem anderen Branch zusammenführen.  

Informationen zu Branches

Branches ermöglichen es Ihnen, Features zu entwickeln, Fehler zu beheben oder sicher mit neuen Ideen in einem eigenständigen Bereich Ihres Repositorys zu experimentieren. 

Sie erstellen immer einen Branch aus einem vorhandenen Branch. In der Regel können Sie einen neuen Branch aus dem Standardbranch Ihres Repositorys erstellen. Sie können dann isoliert von Änderungen, die andere Personen am Repository vornehmen, an diesem neuen Branch arbeiten. Ein Branch, den Sie zum Erstellen eines Features erstellen, wird häufig als Featurebranch- oder Themenbranch bezeichnet. Weitere Informationen findest du unter Erstellen und Löschen von Branches in deinem Repository.

Sie können auch einen Branch verwenden, um eine GitHub Pages Website zu veröffentlichen. Weitere Informationen findest du unter Informationen zu GitHub Pages.

Sie benötigen Schreibzugriff auf ein Repository, um einen Branch zu erstellen, einen Pull Request zu öffnen oder Branches in einem Pull Request zu löschen und wiederherzustellen. Weitere Informationen findest du unter Zugriffsberechtigungen auf GitHub.

Informationen zum Standardbranch

Wenn Sie ein Repository mit Inhalten auf GitHub erstellen, erstellt GitHub das Repository mit einem einzelnen Branch. Dieser erste Branch im Repository ist der Standardbranch. Die Standardbranch ist der Branch, den GitHub anzeigt, wenn jemand Ihr Repository besucht. Der Standardbranch ist auch der anfängliche Branch, den Git lokal auscheckt, wenn jemand das Repository klont. Sofern Sie keinen anderen Branch angeben, ist der Standardbranch in einem Repository der Basisbranch für neue Pull Requests und Codecommits.

Standardmäßig benennt GitHub die Standardbranch Standard in jedem neuen Repository. 

Sie können die Standardbranch für ein vorhandenes Repository ändern. Weitere Informationen findest du unter Ändern der Standardbranch.

Du kannst den Namen des Standardbranch für neue Repositorys festlegen. Weitere Informationen findest du unter Verwalten der Standardbranch für deine Repositorys, Verwalten des Standardbranch Namens für Repositorys in deinem organization und Erzwingen von Repositoryverwaltungsrichtlinien in deinem Enterprise-Konto.

Arbeiten mit Branches

Sobald Sie mit Ihrer Arbeit zufrieden sind, können Sie einen Pull Request öffnen, um die Änderungen in der aktuellen Verzweigung (dem Hauptbranch) in einem anderen Branch (dem Basisbranch) zusammenzuführen. Weitere Informationen findest du unter Informationen zu Pull Requests."

Nachdem ein Pull Request zusammengeführt oder geschlossen wurde, können Sie den Head-Branch löschen, da er nicht mehr benötigt wird. Sie benötigen Schreibzugriff im Repository, um Branches löschen zu können. Verzweigungen, die offenen Pull Requests direkt zugeordnet sind, können nicht gelöscht werden. Weitere Informationen findest du unter Löschen und Wiederherstellen von Branches in einem Pull Request.

Wenn Sie einen Head-Branch löschen, nachdem sein Pull Request zusammengeführt wurde, sucht GitHub nach geöffneten Pull Requests im selben Repository, in dem der gelöschte Branch als Basisbranch angegeben wird. GitHub aktualisiert solche Pull Requests automatisch und ändert ihre Basisbranch in die Basisbranch des zusammengeführten Pull Requests. Die folgenden Diagramme veranschaulichen dies.

Hier hat jemand einen Branch namens feature1 aus dem Standard-Branch erstellt, und Sie haben dann einen Branch mit dem Namen feature2 aus feature1 erstellt. Es gibt offene Pull Requests für beide Branches. Die Pfeile zeigen die aktuelle Basisbranch für jeden Pull Request an. An diesem Punkt ist feature1 der Basisbranch für feature2. Wenn der Pull Request für feature2 jetzt zusammengeführt wird, wird der Feature2-Branch mit feature1 zusammengeführt.

Im nächsten Diagramm hat jemand den Pull Request für feature1 in den master-Branch zusammengeführt und den Branch feature1 gelöscht. Daher hat GitHub den Pull Request für feature2 automatisch neu zugewiesen, sodass sein Basisbranch jetzt master ist.

Wenn Sie nun den Feature2-Pull Request zusammenführen, wird er mit dem Standard  Branch zusammengeführt.

Arbeiten mit geschützten Branches

Repositoryadministratoren können Schutz für einen Branch aktivieren. Wenn Sie an einem geschützten Branch arbeiten, können Sie den Branch nicht löschen oder erzwungener Push. Repositoryadministratoren können zusätzlich mehrere andere geschützter Branch-Einstellungen aktivieren, um verschiedene Workflows zu erzwingen, bevor ein Branch zusammengeführt werden kann.

Um festzustellen, ob Ihr Pull Request zusammengeführt werden kann, sehen Sie sich das Mergefeld unten auf der RegisterkarteConversation des Pull Requests an. Weitere Informationen findest du unter Informationen zu geschützten Branches.

Wenn ein Branch geschützt ist:

• Sie können den Branch nicht löschen oder erzwungener Push.

• Wenn dies erforderlich ist, status Überprüfungen für den Branch aktiviert sind, können Sie die Änderungen erst dann mit dem Branch zusammenführen, wenn alle erforderlichen CI-Tests bestanden wurden. Weitere Informationen findest du unter Informationen status Überprüfungen.

• Wenn erforderliche Pull Request-Überprüfungen für den Branch aktiviert sind, können Sie keine Änderungen in dem Branch zusammenführen, bis alle Anforderungen in der Pull Request-Überprüfungsrichtlinie erfüllt sind. Weitere Informationen findest du unter Zusammenführen eines Pull Requests.

• Wenn die erforderliche Überprüfung von einem Codebesitzer für einen Branch aktiviert ist und ein Pull Request Code mit einem Besitzer ändert, muss ein Codebesitzer den Pull Request genehmigen, bevor er zusammengeführt werden kann. Weitere Informationen findest du unter Informationen zu Codebesitzern.

• Wenn die erforderliche Commitsignatur für einen Branch aktiviert ist, können Sie keine Commits an den Branch pushen, die nicht signiert und überprüft sind. Weitere Informationen findest du unter Informationen zur Commitsignaturüberprüfung und Informationen zu geschützten Branches.

• Wenn Sie den Konflikt-Editor von GitHub verwenden, um Konflikte für einen Pull Request zu beheben, den Sie aus einem geschützter Branch erstellt haben, hilft GitHub Ihnen beim Erstellen eines alternativen Branchs für den Pull Request, damit Ihre Lösung der Konflikte zusammengeführt werden kann. Weitere Informationen findest du unter Beheben eines Mergekonflikts auf GitHub.

Weitere Lektüre

Informationen zu Pull Requests

"Branch" im GitHub-Glossar

"Branches in a Nutshell" in der Git-Dokumentation