Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Se synchroniser sans rien casser

Se synchroniser sans rien casser

Travailler à plusieursintermediaire

Se mettre à jour est le geste le plus répété de la journée et la première cause d'accident. Il se décompose en deux décisions que git pull prend à votre place : qu'est-ce qui est arrivé ? et qu'est-ce que j'en fais ?

git fetch                                      # 1. savoir
git rev-list --left-right --count @{u}...HEAD  # 2. lire la situation
#   3       2      ← ils ont 3 commits, vous en avez 2
git pull --rebase                              # 3. décider, en connaissance

La lecture du milieu tient en un tableau, et c'est lui qui dicte le geste :

Résultat Situation Geste
0 0 identiques rien à faire
0 2 vous êtes en avance git push
3 0 vous êtes en retard avance rapide, aucun risque
3 2 divergence fusion ou rebase — le seul cas qui demande un choix

Trois des quatre lignes n'appellent aucune réflexion. Tout l'enjeu est de reconnaître la quatrième avant de lancer une commande qui tranchera seule.

origin/main n'est pas le serveur, c'est votre souvenir du serveur. Cette phrase, qui ressemble à un détail pédagogique, est le mécanisme exact sur lequel repose --force-with-lease. Un bail accordé sur un souvenir rafraîchi n'est plus un bail.

git config pull.ff only          # échoue au lieu de fusionner dans mon dos
git config fetch.prune true      # purge les branches disparues à chaque fetch
git config push.default simple   # pousse la branche courante, vers son amont

Ces trois lignes suppriment la majorité des surprises quotidiennes, sans apprendre une seule commande de plus.

Les termes à connaître

@{upstream}

Raccourci vers la branche distante que la branche courante suit, abrégé @{u}. git log @{u}.. liste ce que vous avez en plus, sans avoir à écrire origin/ ni le nom de la branche — donc sans se tromper de branche en copiant une commande.

@{push}

La branche vers laquelle un git push enverrait, qui n'est pas toujours celle d'où l'on tire. Dans un flux triangulaire — on tire de upstream, on pousse sur son fork — @{u} et @{push} désignent deux branches différentes, et git status ne parle que de la première.

Divergence chiffrée

git rev-list --left-right --count @{u}...HEAD renvoie deux nombres : les commits qu'ils ont et que vous n'avez pas, puis l'inverse. Les trois points sont obligatoires ; avec deux, la commande répond à une autre question.

pull.ff = only

Réglage qui fait échouer git pull dès que la fusion ne serait pas une avance rapide, au lieu de fusionner ou de rebaser dans votre dos. Transforme une divergence en message d'erreur, au moment où l'on a encore le choix de ce qu'on en fait.

Bail explicite

git push --force-with-lease=panier:<empreinte> : on nomme soi-même l'état du distant qu'on accepte d'écraser, au lieu de laisser Git lire la référence de suivi. Seule forme du bail qui résiste à un fetch involontaire.

--force-if-includes

Contrôle supplémentaire : le bail n'est accordé que si les commits distants récupérés ont réellement été intégrés à votre travail. Répond au trou de --force-with-lease seul, qui se contente de constater que vous avez vu le commit, pas que vous l'avez repris.

git range-diff

Compare deux séries de commits deux à deux plutôt que ligne à ligne : git range-diff @{u}...HEAD montre ce que le rebase a changé en plus du replacement. C'est la relecture qui précède une poussée forcée.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.