git-flow Spickzettel

OSX

Homebrew

$ brew install git-flow

Macports

$ port install git-flow

Linux

$ apt-get install git-flow

Windows (Cygwin)

$ wget -q -O - --no-check-certificate https://github.com/nvie/gitflow/raw/develop/contrib/gitflow-installer.sh | bash

Du benötigst wget und util-linux um git-flow zu installieren.

Für eine detaillierte git-flow Installationsanleitung, besuche bitte das git flow wiki.

Initialisierung

Fange an mit git-flow zu arbeiten, indem Du es innerhalb eines bestehenden Git-Repository initialisierst:

git flow init

Dabei musst Du einige Fragen bezueglich der Namenskoventionen Deiner Branches (Entwicklungszweige) beantworten.
Es wird empfohlen, die Standardwerte zu verwenden.

Entwicklung neuer Features

Neue Features werden vom 'develop'-Branch abgeleitet.

Starte die Entwicklung eines neuen Features mittels

git flow feature start MYFEATURE

Dieser Befehl erstellt einen neuen Feature-Branch basierend auf 'develop' und wechselt in diesen.

Fertigstellung eines Features

Beende die Entwicklung eines Features. Dies führt zu folgenden Aktionen:

• Zusammenführen von MYFEATURE in den 'develop'-Branch (Merge-Prozess)
• Entfernt den Feature-Branch
• Wechselt zurück in den 'develop'-Branch

git flow feature finish MYFEATURE

Veröffentlichen eines Features

Entwickelst Du ein Feature in Zusammenarbeit?
Veröffentliche Dein Feature auf einem entfernten Server, so dass es auch von anderen verfolgt werden kann.

git flow feature publish MYFEATURE

Holen eines veröffentlichten Features

Hole ein Feature, welches von einem anderen Nutzer veröffentlicht wurde.

git flow feature pull origin MYFEATURE

Du kannst ein Feature unter Verwendung von

git flow feature track MYFEATURE

auf 'origin' verfolgen.

Beginne ein Release

Um ein neues Releases zu beginnen, benutze den git flow release Befehl. Mit diesem wird ein Release-Branch vom aktuellen 'develop'-Branch erstellt.

git flow release start RELEASE [BASE]

Du kannst optional einen [BASE] Commit sha-1 Hash bereitstellen, um ein Release von diesem Commit zu starten. Der Commit muss sich im 'develop'-Branch befinden.

★ ★ ★

Es ist ratsam, den Release-Branch nach der Erstellung zu veröffentlichen und damit anderen Entwicklern die Möglichkeit für Comitts zu geben. Mache es ähnlich wie bei einem Feature-Branch mit dem Befehl:

git flow release publish RELEASE

(Du kannst ein entferntes Remote-Release mittels
git flow release track RELEASE verfolgen.)

Fertigstellung eines Releases

Das Beenden eines Releases ist einer der größten Schritte im Git-Branching-Prozess. Es bewirkt folgende Aktionen:

• Zusammenführen des Release-Branches zurück in den 'master'-Branch. (Merge-Prozess)
• Markiert (Tagged) das Release mit seinem Namen
• Zurückführen des Releases in den 'develop'-Branch (Merge-Prozess)
• Entfernt den Release-Branch

git flow release finish RELEASE

Vergesse nicht Deine Tags mittels git push --tags zu pushen.

git flow hotfix start

Ähnlich wie auch die anderen git-flow Befehle, wird ein Hotfix mittels

git flow hotfix start VERSION [BASENAME]

begonnen. Das VERSION-Argument markiert hierbei den neuen Hotfix-Release-Namen. Optional kannst Du auch einen BASENAME spezifizieren.

Fertigstellung eines Hotfixes

Mit dem Beenden eines Hotfixes, wird dieser in den 'develop'- und 'master'-Branch zusammengeführt (Merge). Nebenbei wird der 'master'-Branch mit einem Tag welcher die Hotfix-Version beinhaltet markiert.

git flow hotfix finish VERSION