Recentemente ho convertito i miei repository Subversion verso GIT.
La conversione in parte è dolorosa perché GIT è più difficile e complicato da usare rispetto a SVN ma offre un paio di vantaggi di cui ho bisogno: ottimizzazione della banda (possibilità di lavorare offline), migliore gestione dei branch. Prima o poi scriverò un post a riguardo dei vantaggi/svantaggi.
Convertire un repository non è una cosa così immediata, mi ci sono volute molte prove e la documentazione di GIT non è poi così completa. La maggior parte degli esempi che si trova in rete si riferisce all’uso di SVN con GIT, o all’importazione di un repository Subversin in locale e non ad una conversione completa in remoto.
Ecco le condizioni:
- Convertire un repository SVN ad uno in GIT, eliminando quindi il vecchio repository alla fine del passaggio.
- Il repository GIT deve trovarsi in un server remoto.
- I tag e i branch vanno convertiti correttamente nei corrispettivi in GIT.
- Il “trunk” deve diventare il “master”.
- Il repository Subversion da copiare si trova all’indirizzo svn://login1@server1/repository/progetto1/
- Il repository di destinazione GIT, già pronto ad accogliere i nuovi dati, si trova all’indirizzo git://login2@server2/repository/progetto2.git
- I comandi eseguiti non devono avere nessun effetto sul vecchio repository, in modo da poter ripetere la procedura da capo se qualcosa va storto.
Dopo aver provato la versione 1.5.2 di GIT, ho capito che non era adatta per questo lavoro dato che non era ancora pronta per via di qualche bug. Sono quindi passato alla versione 1.6.3, ma già la versione 1.5.3 potrebbe andare bene.
Il primo passaggio è quello di clonare in locale il primo repository sul nostro computer:
git svn clone -s svn://login1@server1/repository/progetto1/ progetto
Il parametro “-s” indica di utilizzare i nomi di default per “trunk”, “branches” e “tags”, in modo da individuare le directory giuste. E’ possibile sovrascriverli con i parametri “–trunk”, “–branches” e “–tags”.
L’ultimo parametro “progetto” è il nome della directory da creare in locale.
Una volta eseguito questo comando, git-svn inizierà a scaricare i dati nella directory “progetto”.
Una volta scaricato tutto, indichiamo il repository di destinazione:
cd progettogit remote add origin git://login2@server2/repository/progetto2.git
git-svn non converte direttamente i tag e i branch, ma crea solo dei branch in locale. Vediamo quali tag e quali branch abbiamo da convertire:
git branch -a
Mettiamo che il risultato sia questo:
* master miobranch altrobranch tags/1.0 tags/2.0 trunk
Il parametro “-a” serve a mostrare tutti i branch e non solo quelli locali.
Il branch master non contiene il trunk, ma il branch con l’ultimo commit, per cui sarà da correggere.
Siamo pronti per convertire i tag:
git tag 1.0 tags/1.0git branch -r -d tags/1.0git tag 2.0 tags/2.0git branch -r -d tags/2.0
Il primo comando crea un tag GIT utilizzando il riferimento a quello vecchio (che è in remoto).
Il secondo comando elimina il branch del vecchio tag (opzione “-d”) che si trova in remoto (“-r”).
Il terzo ed il quarto comando eseguono la stessa procedura sul secondo tag.
Ora passiamo alla conversione dei branch:
git checkout -b mionuovobranch miobranchgit checkout -b altrobranch altrobranchgit checkout trunk trunk
Il primo comando converte il branch “miobranch” in “mionuovobranch” cambiandone anche il nome.
Il secondo comando converte il branch “altrobranch” mantenendo lo stesso nome. Questo genererà un errore a cui non bisogna fare caso, proprio perché il vecchio branch ha lo stesso nome di quello nuovo.
Il secondo comando serve a preparare il trunk per sostituirlo al master.
Sostituiamo il master con il trunk:
git branch -D mastergit checkout trunkgit checkout -f -b mastergit branch -d trunk
Il primo comando elimina il master con tutta la sua storia (parametro “-D”).
Il secondo comando ci fa spostare all’interno di trunk.
Il terzo comando crea il branch master basato su trunk (parametro “-b”) e ignora tutti gli eventuali errori (parametro “-f”).
Il quarto comando elimina il branch trunk mantenendo comunque lo storico (parametro “-d”).
Siamo pronti per immettere i dati sul nostro nuovo repository di destinazione:
git push origin mastergit push origin 1.0git push origin 2.0git push origin mionuovobranchgit push origin altrobranch
Il primo comando carica i dati sul repository remoto.
I comandi successivi aggiungono i tag e i branch.
A questo punto il lavoro è finito: possiamo eliminare la direcotory locale di GIT e creare una nuova copia locale pulita.
cd ..rm -fr progettogit clone git://login2@server2/repository/progetto2.git progetto
