git-flow cheatsheet

macOS

$ brew install git-flow-avh

$ port install git-flow-avh

Linux

$ apt-get install git-flow

Windows (Cygwin)

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

Sono necessari wget e util-linux per installare git-flow.

Per le istruzioni dettagliate riguardo all'installazione di git-flow visitate il wiki di git flow.

Inizializzazione

è possibile iniziare ad utilizzare git-flow inizializzandolo all'interno di un repository git esistente:

git flow init

Dovrete rispondere ad alcune domande riguardanti la naming conventions da utilizzarsi per i branch.
Si consglia l'uso dei valori di default proposti.

Iniziare una nuova feature

Lo sviluppo di nuove feature comincia dal branch 'develop'.

Iniziate lo sviluppo di una nuova feature con

git flow feature start MYFEATURE

Questa crea un nuovo feature branch basato su 'develop' e si sposta su quello (ne fa il checkout)

Completamento di una feature

Termina lo sviluppo di una feature. Questa azione esegue le seguenti operazioni

• Merge del branch MYFEATURE nel branch 'develop'
• Rimuove il feature branch usato per lo sviluppo della feature
• Si sposta di nuovo sul branch 'develop'

git flow feature finish MYFEATURE

Pubblicare una feature

State sviluppando una feature in collaborazione con altri?
Pubblicate una feature sul server remoto in modo che possa essere utilizzata da altri utenti.

git flow feature publish MYFEATURE

Scaricare una feature pubblicata

Scaricare dal server remoto una feature pubblicata da un altro utente.

git flow feature pull origin MYFEATURE

Potete tracciare una feature sul repository origin usando git flow feature track MYFEATURE

Iniziare una release

Per iniziare una release usate il comando release di git flow. Crea un release branch a partire dal branch 'develop'.

git flow release start RELEASE [BASE]

Potere facoltativamente fornire nel parametro [BASE] lo sha-1 hash del commit dal quale far partire la release. Il commit deve essere presente nel branch 'develop'.

★ ★ ★

È una buona idea pubblicare il release branch dopo averlo creato in modo da consentire l'invio di release commit anche da parte di altri sviluppatori. Potete farlo, usando un comando analogo a quello usato per pubblicare le features:

git flow release publish RELEASE

(Potete tracciare la release remota con il comando git flow release track RELEASE)

Completamento di una release

Terminare una release è uno dei passi più grandi nella gestione dei branch di git. Vengono eseguite svariate operazioni:

• Merge del release branch su branch 'master'
• Tagging della relase con il suo nome
• Merge all'indietro della relase sul branch 'develop'
• Rimozione del release branch

git flow release finish RELEASE

Non dimenticate di fare il push dei tag creati con git push --tags

git flow hotfix start

Come gli altri comandi di git flow, un hotfix si inizia con

git flow hotfix start VERSION [BASENAME]

La versione passata come argomento definisce il nuovo nome dell'hotfix release. Facoltativamente potete specificare un basename da cui partire (un tag di release sul branch 'master').

completamento di un hotfix

Terminando un hotfix, questo viene integrato (merge) all'indietro all'interno dei branch 'develop' e 'master'. In aggiunta il master viene taggato con la versone dell'hotfix.

git flow hotfix finish VERSION