Einführung in Branches
Mit Branches kannst Du Folgendes tun:
- Funktionen entwickeln
- Fehler beheben
- Sicher mit neuen Ideen experimentieren
Du erstellst einen Branch immer aus einem existierenden Branch. Normalerweise würdest Du einen Branch aus dem master
-Branch deines Repository erstellen. Da kannst dann in diesem Branch unabhängig von Änderungen arbeiten, die andere Personen im Repository machen. Ein Branch, den Du zur Erstellung einer Funktion aufbaust, wird häufig als Funktions-Branch oder Themen-Branch bezeichnet. Weitere Informationen findest Du unter „Branches in Deinem Repository erstellen und löschen.“
Du kannst einen Branch auch verwenden, um eine GitHub Pages-Website zu veröffentlichen. Weitere Informationen findest Du unter „Was sind GitHub-Pages?.“
Du benötigst 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. In Repositorys, in denen Du Inhaber- oder Administratorzugriff hast, kannst du den Standardbranch ändern. Weitere Informationen findest Du unter „Zugriffsberechtigungen auf GitHub Enterprise“ und „Branches in Deinem Repository verwalten.“
Mit Branches arbeiten
Sobald Du mit Deiner Arbeit zufrieden bist, kannst Du einen Pull Request eröffnen, um die Änderungen im aktuellen Branch (dem Head-Branch) in einem anderen Branch (den Basis-Branch) zusammenzuführen. Weitere Informationen findest Du unter „Informationen zu Pull Requests.“
Nachdem ein Pull Request zusammengeführt oder geschlossen wurde, kannst Du den Head-Branch löschen, da dieser nicht mehr länger benötigt wird. Du benötigst Schreibzugriff auf dem Repository, um Branches zu löschen. Du kannst keine Branches löschen, die direkt mit einem offenen Pull Request verbunden sind. Weitere Informationen findest Du unter „Löschen und Wiederherstellen von Branches in einem Pull Request."
Mit geschützten Branches arbeiten
Repository-Administratoren können den Schutz für einen Branch aktivieren. Wenn Du auf einem geschützten Branch arbeitest, kannst Du den Push an den Branch nicht löschen oder erzwingen. Repository-Administratoren können zusätzlich mehrere andere Einstellungen für geschützte Branches aktivieren, um verschiedene Workflows zu erzwingen, bevor ein Branch zusammengeführt werden kann.
Hinweis: Wenn Du ein Repository-Administrator bist, kannst Du Pull Requests auf geschützten Branches zusammenführen, auch wenn der Pull Request nicht den Anforderungen entspricht, es sei denn, der Branch-Schutz wurde auf „Include administrators“ (Administratoren einbeziehen) festgelegt.
Um zu ermitteln, ob Dein Pull Request zusammengeführt werden kann, wirf einen Blick in das Merge-Fenster am unteren Rand der Registerkarte Conversation (Unterhaltung) des Pull Requests. Weitere Informationen findest Du unter „Informationen zu geschützten Branches.“
Wenn ein Branch geschützt ist, trifft Folgendes zu:
- Du kannst einen Push an den Branch nicht löschen oder erzwingen.
- Wenn die erforderlichen Statuschecks für den Branch aktiviert sind, kannst Du Änderungen erst dann in den Branch zusammenführen, wenn alle erforderlichen CI-Tests bestanden sind. Weitere Informationen findest Du unter „Informationen zu Statuschecks.“
- Wenn erforderliche Pull-Request-Reviews auf dem Branch aktiviert sind, kannst Du Änderungen erst dann in den Branch zusammenführen, wenn alle Anforderungen der Richtlinie für Pull-Request-Reviews erfüllt sind. Weitere Informationen findest Du unter „Einen Pull Request zusammenführen.“
- Wenn der erforderliche Review von einem Codeinhaber auf einem Branch aktiviert ist und der Code mit einem Inhaber durch einen Pull Request geändert wird, muss ein Codeinhaber den Pull Request genehmigen, bevor er zusammengeführt werden kann. Weitere Informationen findest Du unter „Informationen zu Codeinhabern.“
- Wenn die obligatorische Commit-Signatur auf einem Branch aktiviert ist, kannst Du keine Commits an den Branch übertragen, die nicht signiert und verifiziert sind. Weitere Informationen findest Du unter „Informationen zur Verifizierung der Commit-Signatur“ und „Informationen zur obligatorischen Commit-Signatur.“
Weiterführende Informationen
- „Informationen zu Pull Requests“
- „Branch“ im GitHub-Glossar
- „Branches auf einen Blick“ in der Git-Dokumentation