GitHub e le pull request, se qualcosa va storto
Dieci messaggi, dieci uscite
I messaggi che vedrai di più parlando con l'album online. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Le righe che cominciano con hint: sono i consigli di Git: leggile, spesso dicono già il comando.
Prima di tutto, due domande che risolvono mezzi problemi: su quale branch sono? (git status, la prima riga) e a cosa è collegato? (git branch -vv, tra parentesi quadre).
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
! [rejected] festivi -> festivi (fetch first) | Online c'è un commit che tu non hai: un collega è arrivato prima, sullo stesso branch | git pull (arriva il suo lavoro, si fa un merge), poi git push. Mai --force: butterebbe il suo commit |
remote: error: GH006: Protected branch update failed for refs/heads/main (anche protected branch) | main è protetto: nessun push diretto, nemmeno forzato | Un branch dal punto in cui sei: git switch -c nome (il commit viene con te). Poi git push -u origin nome e la pull request. Alla fine git switch main, git pull |
fatal: The current branch festivi has no upstream branch | È un branch nuovo e Git non sa a quale branch online collegarlo | git push -u origin festivi. Una volta sola |
There is no tracking information for the current branch (con git pull) | Stesso motivo: il branch non è collegato, quindi pull non sa da dove prendere | Se il branch è online: git branch --set-upstream-to=origin/nome. Se è solo tuo: prima git push -u origin nome |
fatal: Need to specify how to reconcile divergent branches | Le due storie si sono separate e Git non sa se unirle con un merge o con un rebase | git config pull.rebase false (il merge, solo in questo repository) oppure con --global per sempre. Poi rifai git pull |
fatal: invalid reference: squadra-menta (con git switch) | Il tuo Git non conosce un branch con quel nome: o è scritto male, o è nato online dopo il tuo clone | git fetch, poi git branch -a per vedere i nomi. Se compare origin/squadra-menta, git switch squadra-menta lo prende |
Il pulsante Merge pull request è grigio (e sotto, This branch has conflicts that must be resolved) | Manca l'approvazione di chi deve rivedere, oppure la PR va in conflitto con la sua base | Se manca l'approvazione: chiedila al revisore. Se c'è il conflitto: porta la base nel tuo branch (git pull origin nome-della-base), risolvi come nel capitolo I conflitti, git push |
There isn't anything to compare (la PR non parte) | Il branch e la sua base hanno già gli stessi commit: hai dimenticato il commit, o il git push, o il branch è lo stesso della base | git log --oneline per controllare il commit, git push se manca. Su un branch diverso dalla base: git switch -c nome |
La PR è andata verso il branch sbagliato (in cima dice base: main invece di base: squadra-menta) | La base di default è main | Prima del merge: Edit in cima alla PR e scegli la base giusta, oppure gh pr edit --base squadra-menta. Il branch non si rifà |
Si apre un editor dopo git pull | Il pull ha fatto un merge e Git ti chiede il messaggio | Tieni quello proposto: nano: Ctrl+O, Invio, Ctrl+X · vim: Esc, poi :wq e Invio. La volta dopo: git pull --no-edit |
I messaggi Repository not found e Authentication failed succedono solo con il GitHub vero, non nelle missioni: vuol dire che l'indirizzo è sbagliato, o che non hai ancora fatto l'accesso al tuo account. L'account e gh auth login non sono di questo libro: se ti servono, c'è il Pronto soccorso.
ahead e behind non sono errori
git status ti dice come stai messo rispetto all'etichetta origin/…:
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Your branch is ahead of 'origin/main' by 1 commit | Hai un commit che online non ha | git push (se il branch è tuo) |
Your branch is behind 'origin/main' by 2 commits, and can be fast-forwarded | Online c'è qualcosa che tu non hai, e non hai niente di tuo da unire | git pull |
Your branch and 'origin/festivi' have diverged | Tutti e due avete qualcosa di nuovo | git pull, poi git push |
Your branch is up to date with 'origin/main' | Come l'ultima volta che hai guardato | Non vuol dire «come adesso»: git fetch e riguarda |
Gli errori che non danno errori
I più difficili sono quelli senza messaggio: tutto sembra a posto, il test è rosso o la PR è sbagliata.
Il main vecchio. Hai fatto la PR e sei andato avanti: il tuo main non è cambiato. Dopo ogni PR unita, git switch main e git pull. Se non lo fai, il prossimo branch parte da una foto vecchia.
Il branch che nasce dal posto sbagliato. Il tuo branch deve partire dal branch con cui la PR verrà unita. Prima di git switch -c, controlla dove sei: git status e git log --oneline -3.
La PR verso main, invece che verso la squadra. La base di default è main. Se il lavoro va in un branch di squadra, la base si dice prima di aprire la PR: gh pr create --base squadra-menta --fill.
Il push --force che «funziona». Non dà errori. Butta i commit degli altri. Se un comando ti suggerisce --force per far passare un push, torna indietro e leggi cosa sta rifiutando.
Per trovarli: git log --oneline --graph --all. Il disegno dice subito dove sono le etichette origin/…, il tuo branch e quello dei colleghi.