Nel modello di sviluppo fork-based gli sviluppatori, invece di farsi un proprio branch sul repository principale, effettuano una fork dell'intero repository sul proprio account di GitHub, su cui andranno a pushano le modifiche. Quando poi si vogliono integrare le proprie modifiche dal proprio repository GitHub a quello principale, si andra' ad effettuare una pull request da interfaccia web. NB: questo vale sia per i contributori esterni che per ogni core developer.

Di seguito descriveremo dettagliatamente i passaggi da effettuare per Gasista Felice.

Dopo aver effettuato l'accesso su Github, andare sul seguente repository da browser: https://github.com/befair/gasistafelice e cliccare su “Fork”.

Fatto questo, il repository gasistafelice apparirà sulla propria pagina personale di Github.

Cambiare i riferimenti di origin all'interno del file di config (.git/config) nel seguente modo:

  [remote "origin"]
  url = git@github.com:tuo_nick_github/gasistafelice.git
  fetch = +refs/heads/*:refs/remotes/origin/*

Aggiungendo un nuovo remote che punta al repository ufficiale:

  [remote "upstream"]
  url = git@github.com:befair/gasistafelice.git
  fetch = +refs/heads/*:refs/remotes/origin/*

Mi posiziono all'interno del master del mio repository in locale.

$ git checkout master

Effettuo un merge del mio branch master con quello del repository ufficiale (upstream → git@github.com:befair/gasistafelice.git)

$ git pull upstream master

Mi sposto sul mio branch in locale di sviluppo (in questo caso, my-dev-branch)

$ git checkout my-dev-branch

Effettuo un rebase (un import) del mio branch (my-dev-branch) con il master, quindi: - importo le nuove modifiche del master - riapplico i miei commit piu' recenti dopo quelli importati dal master

$ git rebase master

In caso di problemi fixare a mano eventuali conflitti, come segnalato (e come si fa normalmente).

$ git push origin my-dev-branch:master

Effettuo un push di my-dev-branch sul branch master di origin (origin → git@github.com:tuo_nick_github/gasistafelice.git) In questo modo pusherò il mio branch di sviluppo sul mio repository online.

Per effettuare una PULL REQUEST bisogna andare sul repository ufficiale (befair/gasistafelice.git) e cliccare su “Pull Request” dal menù a destra. Ci verrà chiesto di selezionare su quale branch del repository effettuare la request.

Nota: Se la pull request non viene integrata subito e vengono fatte altre modifiche in upstream (repository principale) incompatibili con la pull request (ad esempio se vengono modificati gli stessi file), lo sviluppatore dovra' fare nuovamente il rebase:

$ git checkout master
$ git pull upstream master
$ git checkout my-dev-branch
$ git rebase master
(risolvo conflitti e ricommitto, come suggerisce Git stesso)

Di conseguenza, se ora rieffettiamo la push verso l'origin (il proprio repository forkato):

$ git push origin my-dev-branch:master

Viene riportato un conflitto, e bisognera' aggiungere –force per forzare l'operazione:

$ git push origin my-dev-branch:master --force

A questo punto, rieffettuare la pull request

Generare una chiave SSH:

$ ssh-keygen -t rsa -b 4096

Stampare (e copiare) la chiave pubblica appena generata (in genere):

$ cat ~/.ssh/id_rsa.pub

Dall'interfaccia di Github, aggiungere la chiave appena copiata alle proprie chiavi SSH. In questo modo si evitera' di dover digitare nick/password ogni qualvolta si vuole fare una push sul proprio repository.