Comment définir une branche en amont dans Git

Pour pousser une nouvelle branche et la définir en amont, exécutez `git push -u origin my-branch`. Si la branche existe déjà sur le dépôt distant, exécutez git branch -u origin/my-branch à la place. Après cela, clair git push et git pull sachent où aller. -u est l'abréviation de --set-upstream.

Qu’est-ce qu’une branche amont dans Git ?

La branche amont, également appelée branche de suivi, est la branche distante liée à votre branche locale. Git utilise ce lien pour trois choses : où git pull et git push vont sans arguments, à quoi comptent l'avance et le retard dans git status et ce que signifie le raccourci @{u}.

Comment définir l'amont d'une nouvelle branche ?

git switch -c feature/search
git push -u origin feature/search

Cela crée la branche sur le dépôt distant et relie les deux. Vous n'avez besoin que de -u au premier appui. Le guide de création et de changement de branche couvre l'étape précédant celle-ci.

Comment définir l'amont d'une branche existante ?

Lorsque la branche distante existe déjà, liez-la sans pousser :

# the branch you are on
git branch -u origin/feature/search

# any other branch
git branch -u origin/main main

La forme longue est git branch --set-upstream-to=origin/main. Si Git indique que la branche distante n'existe pas, exécutez d'abord git fetch.

Comment puis-je corriger « La branche actuelle n'a pas de branche en amont » ?

Git affiche ceci lorsque vous exécutez git push sur une branche qui n'a jamais été poussée :

fatal: The current branch feature/search has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin feature/search

Exécutez la commande suggérée. Pour ne plus voir l'erreur, demandez à Git de faire cela à chaque premier push (Git 2.37 ou version ultérieure) :

git config --global push.autoSetupRemote true

Le message associé « Il n'y a aucune information de suivi pour la branche actuelle » provient de git pull. Le correctif est le même : git branch -u origin/my-branch.

Comment puis-je voir ce qu’une branche suit ?

# every branch, with its upstream and ahead/behind
git branch -vv

# only the current branch
git rev-parse --abbrev-ref @{u}

# commits you have not pushed
git log @{u}..

# commits you have not pulled
git log ..@{u}

Comment modifier ou supprimer un amont ?

# point the branch somewhere else
git branch -u origin/develop

# stop tracking anything
git branch --unset-upstream

Aucune des deux commandes ne modifie les commits. Ils modifient uniquement les paramètres de la branche dans .git/config.

Que signifie en amont sur un fork ?

Le mot a un deuxième sens. Sur un fork, upstream est par convention le nom d'un distant : le projet original à partir duquel vous avez dérivé, tandis que origin est votre propre copie. C’est à cela que sert « git Remote Add Upstream » :

git remote add upstream https://github.com/original/project.git
git fetch upstream
git switch main
git merge upstream/main
git push origin main

Voir définir le suivi et publier une branche pour plus de détails, et la leçon sur les dépôts distants et en amont pour vous entraîner.