Cosa significa FETCH_HEAD in Git?

git pull --help dice:

Nella sua modalità predefinita, git pullè una scorciatoia per git fetchseguita da git merge FETCH_HEAD.

Cos'è questo FETCH_HEADe cosa viene effettivamente unito durante git pull?

FETCH_HEADè un riferimento di breve durata, per tenere traccia di ciò che è appena stato recuperato dal repository remoto. git pullprima invoca git fetch, in casi normali il recupero di un ramo dal telecomando; FETCH_HEADpunta alla punta di questo ramo (memorizza lo SHA1 del commit, proprio come fanno i rami). git pullquindi invoca git merge, fondendosi FETCH_HEADnel ramo corrente.

Il risultato è esattamente quello che ti aspetteresti: il commit sulla punta del ramo remoto appropriato viene unito al commit sulla punta del ramo corrente.

È un po 'come fare git fetchsenza argomenti (o git remote update), aggiornare tutti i tuoi rami remoti, quindi eseguirli git merge origin/<branch>, ma usare FETCH_HEADinternamente invece per fare riferimento a qualsiasi riferimento singolo recuperato, invece di dover nominare le cose.

FETCH_HEAD è un riferimento alla punta dell'ultimo recupero, indipendentemente dal fatto che quel recupero sia stato avviato direttamente utilizzando il comando fetch o come parte di un pull. Il valore corrente di FETCH_HEAD viene memorizzato nella .gitcartella in un file chiamato, avete indovinato, FETCH_HEAD.

Quindi se emetto:

git fetch https://github.com/ryanmaxwell/Fragaria

FETCH_HEAD può contenere

3cfda7cfdcf9fb78b44d991f8470df56723658d3        https://github.com/ryanmaxwell/Fragaria

Se il repository remoto è configurato come ramo di tracciamento remoto, posso seguire il mio recupero con un'unione del ramo di rilevamento. In caso contrario, posso unire la punta dell'ultimo recupero direttamente utilizzando FETCH_HEAD.

git merge FETCH_HEAD

Come menzionato nella risposta di Jonathan , FETCH_HEAD corrisponde al file .git/FETCH_HEAD. In genere, il file sarà simile al seguente:

71f026561ddb57063681109aadd0de5bac26ada9                        branch 'some-branch' of <remote URL>
669980e32769626587c5f3c45334fb81e5f44c34        not-for-merge   branch 'some-other-branch' of <remote URL>
b858c89278ab1469c71340eef8cf38cc4ef03fed        not-for-merge   branch 'yet-some-other-branch' of <remote URL>

Nota come sono contrassegnati tutti i rami tranne uno not-for-merge. Quello dispari è il ramo che è stato estratto prima del recupero. In sintesi: FETCH_HEAD corrisponde essenzialmente alla versione remota del ramo attualmente estratto.

Ho appena scoperto e usato FETCH_HEAD. Volevo una copia locale di alcuni software da un server e l'ho fatto

git fetch gitserver release_1

gitserverè il nome della mia macchina che memorizza i repository git. release_1è un tag per una versione del software. Con mia sorpresa, non è release_1stato possibile trovare da nessuna parte sulla mia macchina locale. Ho dovuto scrivere

 git tag release_1 FETCH_HEAD 

per completare la copia della catena di commit contrassegnata (release_1) dal repository remoto a quello locale. Fetch aveva trovato il tag remoto, copiato il commit sul mio computer locale, non aveva creato un tag locale, ma aveva impostato FETCH_HEADil valore del commit, in modo che potessi trovarlo e usarlo. Ho quindi usato FETCH_HEADper creare un tag locale che corrispondeva al tag sul telecomando. Questa è una illustrazione pratica di ciò che FETCH_HEADè e come può essere usato, e potrebbe essere utile a qualcun altro che si chiede perché Git Fetch non faccia ciò che ci si aspetterebbe ingenuamente.

A mio avviso, è meglio evitarlo a tale scopo e un modo migliore per raggiungere quello che stavo cercando di fare è

git fetch gitserver release_1:release_1

cioè per scaricare release_1 e chiamarla release_1 localmente. (È fonte: dest, vedi https://git-scm.com/book/en/v2/Git-Internals-The-Refspec ; nel caso in cui desideri dargli un nome diverso!)

A volte potresti voler usare FETCH_HEAD: -

git fetch gitserver bugfix1234
git cherry-pick FETCH_HEAD

potrebbe essere un buon modo di usare la correzione bug numero 1234 dal tuo server Git e di lasciare la garbage collection di Git per smaltire la copia dal server una volta che la correzione è stata selezionata sul tuo ramo corrente. (Suppongo che ci sia un bel commit con tag pulito che contiene l'intera correzione del bug sul server!)

git pull è una combinazione di un recupero seguito da un'unione. Quando si verifica git fetch, rileva il commit principale di ciò che ha recuperato in FETCH_HEAD (solo un file con quel nome in .git) e questi commit vengono quindi uniti nella directory di lavoro.