Git Branch: come ri­no­mi­na­re i rami locali e remoti

È possibile ri­no­mi­na­re un ramo Git, sia locale che remoto, usando il comando -m. Sebbene questa ope­ra­zio­ne sia ab­ba­stan­za semplice nel caso dei rami locali, per ef­fet­tua­re il cambio sui rami remoti bisognerà prima eliminare la versione obsoleta e so­sti­tuir­la con quella nuova.

Git è un sistema di controllo delle versioni reso di­spo­ni­bi­le gra­tui­ta­men­te e senza licenza dal 2005. La ca­rat­te­ri­sti­ca speciale di questo strumento è che permette a numerosi svi­lup­pa­to­ri di lavorare con­tem­po­ra­nea­men­te sullo stesso progetto e in modo com­ple­ta­men­te autonomo. Ciò è possibile poiché Git non funziona tramite l’utilizzo di un re­po­si­to­ry centrale ma permette ad ogni utente di scaricare una copia sul proprio computer locale, il quale agisce anche da backup. Inoltre, Git è di facile ap­pren­di­men­to e si distingue per la comodità d’uso. Sco­pri­te­ne di più sulla nostra guida digitale, in cui troverete un tutorial su Git che vi aiuterà a muovere i primi passi ga­ran­ten­do un inizio rapido per i vostri progetti.

Per capire come ri­no­mi­na­re un ramo Git, è con­si­glia­bi­le dare prima un’occhiata a come Git è ef­fet­ti­va­men­te strut­tu­ra­to e uti­liz­za­to. Il re­po­si­to­ry Git è fon­da­men­ta­le a questo proposito poiché viene uti­liz­za­to come una sorta di bacino di raccolta. Tutti i file delle versioni attuali e pre­ce­den­ti di un progetto vengono me­mo­riz­za­ti nel re­po­si­to­ry e resi di­spo­ni­bi­li a tutti gli svi­lup­pa­to­ri. Ciò permette di tracciare fa­cil­men­te i cam­bia­men­ti e cor­reg­ge­re ra­pi­da­men­te possibili errori. In contrasto con sistemi come SVN quindi, Git non si sviluppa su un re­po­si­to­ry centrale ma su numerose copie locali, per­met­ten­do ad ogni svi­lup­pa­to­re di lavorare su queste in modo in­di­pen­den­te.

Separare le fasi di lavoro riuscendo comunque a mantenere una visione d’insieme è ancora più im­por­tan­te nel caso in cui un gran numero di svi­lup­pa­to­ri lavori su un progetto per­se­guen­do diversi approcci. A questo scopo, Git usa i co­sid­det­ti rami. L’immagine del ramo si adatta bene a de­scri­ve­re la natura dei rami Git, ovvero numerosi piccoli rami o linee di sviluppo che si staccano dal grande tronco dell’intero progetto perché possano essere mo­di­fi­ca­ti in­di­pen­den­te­men­te. Ciò permette di ag­giun­ge­re nuove ca­rat­te­ri­sti­che o di cor­reg­ge­re i bug più ra­pi­da­men­te senza tuttavia cambiare il codice originale.

In certi casi può essere ne­ces­sa­rio ri­no­mi­na­re un ramo Git poiché, se la de­no­mi­na­zio­ne esistente è sbagliata e altri svi­lup­pa­to­ri con­ti­nua­no ad usarlo, si possono ri­scon­tra­re vari problemi. For­tu­na­ta­men­te, no­no­stan­te la stretta in­te­gra­zio­ne e i vari fork, ri­no­mi­na­re un ramo Git è ab­ba­stan­za semplice. Per procedere basterà usare il comando -m. La sintassi cor­ri­spon­den­te segue sempre la stessa struttura:

“git branch -m <vecchio-nome> <nuovo-nome>”.

Tuttavia, vi sono delle dif­fe­ren­ze tra i rami che possono essere mo­di­fi­ca­ti lo­cal­men­te e quelli che sono già remoti. Di seguito vi spie­ghia­mo i passaggi da seguire in entrambi i casi.

Un ramo locale di Git esiste solo sul vostro computer. Per questo tipo di rami è possibile eseguire modifiche e test senza che gli altri svi­lup­pa­to­ri se ne accorgano. Ri­no­mi­na­re un ramo Git locale è quindi un’ope­ra­zio­ne rapida.

1. Recatevi sulla riga di comando e se­le­zio­na­te il ramo Git che volete ri­no­mi­na­re. Il comando da usare a questo scopo è “git checkout vecchio-nome”.
2. Otterrete quindi una conferma della selezione ef­fet­tua­ta at­tra­ver­so la voce “switched to branch 'vecchio-nome'”.
3. A questo punto eseguite la rinomina effettiva del ramo Git locale. Il comando ap­pro­pria­to a questo fine è “git branch -m nuovo-nome”.

In al­ter­na­ti­va, avrete la pos­si­bi­li­tà di ri­no­mi­na­re il ramo Git uti­liz­zan­do il master. Per procedere seguite i seguenti passaggi:

1. Passate al master tramite il comando “git checkout master”.
2. A questo punto inserite il comando “git branch -m vecchio-nome nuovo-nome” per ri­no­mi­na­re un ramo Git.
3. Per as­si­cu­rar­si che la rinomina abbia avuto successo, re­cu­pe­ra­te lo stato attuale del ramo usando il comando “git branch -a”.

In un re­po­si­to­ry remoto, invece, non potrete sem­pli­ce­men­te ri­no­mi­na­re un ramo Git poiché questo por­te­reb­be a delle com­pli­ca­zio­ni. In questo caso è ne­ces­sa­rio eliminare il vecchio nome e in seguito ag­giun­ge­re il ramo con il nuovo nome. For­tu­na­ta­men­te, anche quest’ope­ra­zio­ne non è complessa e può essere eseguita at­tra­ver­so pochi semplici comandi. Come per il ramo locale, si dispone di due opzioni.

1. Per prima cosa, as­si­cu­ra­te­vi che il ramo locale sia nominato cor­ret­ta­men­te. Il comando ap­pro­pria­to a questo scopo è “git branch -a”.
2. Eliminate quindi il ramo con il nome errato dal re­po­si­to­ry remoto usando il comando “git push origin --delete vecchio-nome”.
3. Ve­ri­fi­ca­te che il vecchio ramo sia stato eliminato cor­ret­ta­men­te.
4. A questo punto ag­giun­ge­te il ramo con il nome corretto uti­liz­zan­do il comando “git push origin -u nuovo-nome”.
5. Infine, eseguite un reset del ramo upstream per as­si­cu­rar­vi che le modifiche siano andate a buon fine.

Se, tuttavia, de­si­de­ra­te ri­no­mi­na­re il ramo Git remoto con un solo comando, è anche di­spo­ni­bi­le una seconda opzione.

1. Inserite il seguente comando: “git push origin :vecchio-nome nuovo-nome”.
2. In seguito, eseguite anche un reset del ramo upstream come già descritto in pre­ce­den­za.

Gli errori capitano e Git è pro­get­ta­to per per­met­ter­vi di ri­no­mi­na­re fa­cil­men­te e ra­pi­da­men­te i rami at­tra­ver­so l’utilizzo di alcuni semplici comandi. Mentre per i rami locali il processo è una rinomina diretta, nel caso dei rami remoti è ne­ces­sa­rio, come primo passaggio, ef­fet­tua­re l’eli­mi­na­zio­ne del ramo avente la de­no­mi­na­zio­ne errata. In entrambi i casi, una volta risolto l’errore, è con­si­glia­to ri­con­trol­la­re at­ten­ta­men­te. Dopodiché si potrà con­ti­nua­re a lavorare su un dato progetto senza alcuna re­stri­zio­ne.