git remote

Partager et mettre à jour

Gérer les dépôts distants avec lesquels vous vous synchronisez

La commande 'git remote' liste, ajoute et supprime des dépôts distants — des noms courts pour les URL d’autres dépôts. git clone en crée un appelé origin. Les forks en ajoutent souvent un second, upstream, qui pointe vers le projet d’origine. Ajouter un dépôt distant ne télécharge rien ; c’est git fetch <name> qui le fait.

Synopsis

git remote [-v | --verbose]
git remote add <name> <url>
git remote remove <name>
git remote rename <old> <new>
git remote set-url <name> <newurl>
git remote show <name>
[ ] facultatif| ou<arg> valeur à remplacer... répétable--flag option

Options

Cliquez sur une option pour la déplier

Débutant (1)

Afficher l’URL de chaque dépôt distant, pour fetch et push.

RecommandéVoir exactement depuis quelle URL vous récupérez et vers laquelle vous poussez

Exemple

git remote -v

Choisir la bonne option

origin ou upstream

Les deux dépôts distants habituels d’un fork

CommandePointe versVous y poussez ?
originVotre copie (le fork)Oui
upstreamLe projet d’origineNon — vous y faites des fetch

Exemples

Lister les dépôts distants

git remote -v

Les noms avec leurs URL.

Ajouter l’original d’un fork

git remote add upstream git@github.com:acme/shop.git

Un second dépôt distant.

Changer une URL

git remote set-url origin git@github.com:you/shop.git

P. ex. passer de HTTPS à SSH.

Détails

git remote show origin

Branches et informations de suivi.

Exemples de workflows

1
git remote add upstream git@github.com:acme/shop.git

Une fois

2
git fetch upstream

Télécharger ses commits

3
git merge upstream/main

Les intégrer à votre main

4
git push

Mettre à jour votre fork

Dépannage

error: remote origin already exists

Cause : Le nom est déjà pris

Utilisez set-url pour le modifier, ou un autre nom

fatal: 'upstream' does not appear to be a git repository

Cause : Le dépôt distant n’est pas configuré

Ajoutez-le avec git remote add

Astuces et pièges

Bonnes pratiques

  • ✓Nommez upstream le dépôt d’origine d’un fork.
  • ✓Vérifiez git remote -v avant votre premier push.

Erreurs fréquentes

  • ✗S’attendre à ce que git remote add télécharge des commits — lancez git fetch ensuite.
  • ✗Pousser vers upstream au lieu d’origin dans un fork.

FAQ

A:

git remote rename old new.

A:

git remote remove <name> — ses branches de suivi distantes partent aussi.