Git 🌙
Français ▾ Topics ▾ Latest version ▾ git-remote last updated in 2.45.0

NOM

git-remote - Gère un ensemble de dépôts suivis

SYNOPSIS

git remote [-v | --verbose]
git remote add [-t <branche>] [-m <master>] [-f] [--[no-]tags] [--mirror=(fetch|push)] <nom> <URL>
git remote rename [--[no-]progress] <ancien> <nouveau>
git remote remove <nom>
git remote set-head <nom> (-a | --auto | -d | --delete | <branche>)
git remote set-branches [--add] <nom> <branche>…​
git remote get-url [--push] [--all] <nom>
git remote set-url [--push] <nom> <nouvelle-URL> [<ancienne-url>]
git remote set-url --add [--push] <nom> <nouvelle-URL>
git remote set-url --delete [--push] <nom> <URL>
git remote [-v | --verbose] show [-n] <nom>…​
git remote prune [-n | --dry-run] <nom>…​
git remote [-v | --verbose] update [-p | --prune] [(<groupe> | <distant>)…​]

DESCRIPTION

Gère un ensemble de dépôts (« distants ») dont vous suivez les branches.

OPTIONS

-v
--verbose

Être un peu plus verbeux et montrer les urls distantes après les noms. Pour les prometteurs distants, montrer aussi quels filtres (blob:none etc.) sont configurés. NOTE : cette option doit être placée entre remote et la sous-commande.

COMMANDES

Sans argument, affiche la liste des distants existants. Quelques sous-commandes permettent d’appliquer des opĂ©rations sur les distants.

add

Ajouter un distant nommé <nom> pour le dépôt à <URL>. La commande git fetch <nom> peut alors être utilisée pour créer et mettre à jour les branches de suivi à distance <nom>/<branche>.

Avec l’option -f, git fetch <nom> est lancĂ© immĂ©diatement après la mise en place des informations distantes.

Avec l’option --tags, git fetch <nom> importe chaque Ă©tiquette du dĂ©pĂ´t distant.

Avec l’option --no-tags, git fetch <nom> n’importe pas les Ă©tiquettes du dĂ©pĂ´t distant.

Par défaut, seules les étiquettes sur les branches récupérées sont importées (voir git-fetch[1]).

Avec l’option -t <branche>, au lieu du spĂ©cificateur par dĂ©faut de glob pour que le distant suive toutes les branches dans l’espace de noms refs/remotes/<nom>/, un spĂ©cificateur de rĂ©fĂ©rence de suivi uniquement pour <branche> est crĂ©Ă©. Vous pouvez donner plus d’un -t <branche> pour suivre plusieurs branches sans saisir toutes les branches.

Avec l’option -m <master>, une rĂ©f symbolique refs/remotes/<nom>/HEAD est mise en place pour pointer sur la branche <master> du distant. Voir aussi la commande set-head.

Lorsqu’un miroir est crĂ©Ă© avec --mirror=fetch, les refs ne seront pas stockĂ©es dans l’espace de noms refs/remotes/, mais tout ce qui se trouve dans refs/ sur le serveur distant sera directement reflĂ©tĂ© dans refs/ dans le dĂ©pĂ´t local. Cette option n’a de sens que dans les dĂ©pĂ´ts nus, car une rĂ©cupĂ©ration Ă©craserait tous les commit locaux.

Lorsqu’un miroir de poussĂ© est crĂ©Ă© avec --mirror=push, alors git push se comportera toujours comme si --mirror Ă©tait passĂ©.

rename

Renommer le distant nommé <ancien> en <nouveau>. Toutes les branches de suivi à distance et les paramètres de configuration du distant sont mis à jour.

Dans le cas oĂą <ancien> et <nouveau> sont identiques, et que <ancien> est un fichier sous $GIT_DIR/remotes ou $GIT_DIR/branches, le distant est converti au format de fichier de configuration.

remove
rm

Supprimer le distant nommé <nom>. Toutes les branches de suivi à distance et tous les paramètres de configuration du distant sont supprimés.

set-head

DĂ©finir ou supprimet la branche par dĂ©faut (c’est-Ă -dire la cible de la rĂ©fĂ©rence symbolique refs/remotes/<nom>/HEAD) pour le distant nommĂ©. Il n’est pas nĂ©cessaire de disposer d’une branche par dĂ©faut pour un distant, mais cela permet de spĂ©cifier le nom du distant Ă  la place d’une branche spĂ©cifique. Par exemple, si la branche par dĂ©faut pour origin est dĂ©finie Ă  master, alors origin peut ĂŞtre spĂ©cifiĂ© lĂ  oĂą vous spĂ©cifieriez normalement origin/master.

Avec -d ou --delete, la référence symbolique refs/remotes/<nom>/HEAD est supprimée.

Avec -a ou --auto, le distant est interrogĂ© pour dĂ©terminer son HEAD, puis la rĂ©fĂ©rence symbolique refs/remotes/<nom>/HEAD est dĂ©finie sur la mĂŞme branche. Par exemple, si le distant HEAD est pointĂ© sur next, git remote set-head origin -a dĂ©finira la rĂ©fĂ©rence symbolique refs/remotes/origin/HEAD sur refs/remotes/origin/next. Cela ne fonctionnera que si refs/remotes/origin/next existe dĂ©jĂ  ; sinon, il faut d’abord la rĂ©cupĂ©rer.

Utiliser <branche> pour dĂ©finir la rĂ©fĂ©rence symbolique refs/remotes/<nom>/HEAD explicitement. Par exemple, git remote set-head origin master dĂ©finira la rĂ©fĂ©rence symbolique refs/remotes/origin/HEAD Ă  refs/remotes/origin/master. Cela ne fonctionnera que si refs/remotes/origin/master existe dĂ©jĂ  ; sinon, il faut d’abord le rĂ©cupĂ©rer.

set-branches

Modifier la liste des branches suivies par le distant nommĂ©. Cela peut ĂŞtre utilisĂ© pour suivre un sous-ensemble des branches distantes disponibles après la configuration initiale d’un distant.

Les branches nommĂ©es seront interprĂ©tĂ©es comme si elles Ă©taient spĂ©cifiĂ©es avec l’option -t sur la ligne de commande git remote add.

Avec --add, au lieu de remplacer la liste des branches actuellement suivies, ajouter Ă  cette liste.

get-url

Récupèrer les URL pour un distant. Les configurations pour insteadOf et pushInsteadOf sont développées ici. Par défaut, seule la première URL est listée.

Avec --push, on interroge les URL de poussée plutôt que les URL de récupération.

Avec --all, toutes les URL du distant seront listées.

set-url

Modifier les URL pour le distant. Fixer la première URL pour le distant <nom> qui correspond Ă  la regex <ancienne-url> (première URL si aucune <ancienne-url> n’est donnĂ©e) Ă  <nouvelle-url>. Si <ancienne-url> ne correspond Ă  aucune URL, une erreur se produit et rien n’est modifiĂ©.

Avec --push, les URL de poussée sont manipulées au lieu des URL de récupération.

Avec --add, au lieu de modifier les URL existantes, on ajoute une nouvelle URL.

Avec --delete, au lieu de changer les URL existantes, toutes les URL correspondant à la regex <URL> sont supprimées pour le distant <nom>. Essayer de supprimer toutes les URL non poussée est une erreur.

Notez que l’URL de poussĂ©e et l’URL de rĂ©cupĂ©ration, mĂŞme si elles peuvent ĂŞtre dĂ©finies diffĂ©remment, doivent toujours se rĂ©fĂ©rer au mĂŞme endroit. Ce que vous avez poussĂ© Ă  l’URL de poussĂ©e doit ĂŞtre ce que vous verriez si vous alliez rĂ©cupĂ©rer immĂ©diatement Ă  l’URL de rĂ©cupĂ©ration. Si vous essayez de rĂ©cupĂ©rer depuis un endroit (par exemple votre site en amont) et de pousser Ă  un autre (par exemple votre dĂ©pĂ´t de publication), utilisez deux distants distincts.

show

Fournir quelques informations sur le dépôt <nom>.

Avec l’option -n, les branches distantes ne sont pas interrogĂ©es en premier avec git ls-remote <nom> ; les informations en cache sont utilisĂ©es Ă  la place.

prune

Supprimer les rĂ©fĂ©rences pĂ©rimĂ©es associĂ©es Ă  <nom>. Par dĂ©faut, les branches de suivi Ă  distance pĂ©rimĂ©es sous <nom> sont supprimĂ©es, mais en fonction de la configuration globale et de la configuration du distant, nous pourrions mĂŞme Ă©laguer les Ă©tiquettes locales qui n’y ont pas Ă©tĂ© poussĂ©es. Équivalent Ă  git fetch --prune <nom>, sauf qu’aucune nouvelle rĂ©fĂ©rence ne sera rĂ©cupĂ©rĂ©e.

Voir la section ÉLAGAGE de git-fetch[1] pour savoir ce qui sera élagué en fonction des différentes configurations.

Avec l’option --dry-run, signaler les branches qui seraient Ă©laguĂ©es, mais ne pas rĂ©ellement les Ă©laguer.

update

RĂ©cupĂ©rer les mises Ă  jour pour les distants ou les groupes de distants dans le dĂ©pĂ´t comme dĂ©fini par remotes.<groupe>. Si aucun groupe ni aucun distant n’est spĂ©cifiĂ© sur la ligne de commande, le paramètre de configuration remotes.default sera utilisé ; si remotes.default n’est pas dĂ©fini, tous les distants dont le paramètre de configuration remote.<nom>.skipDefaultUpdate n’est pas dĂ©fini Ă  true seront mis Ă  jour. (Voir git-config[1]).

Avec l’option --prune, lancer l’Ă©lagage contre tous les distants qui sont mises Ă  jour.

DISCUSSION

Le paramètrage des informations de connexion est réalisé par les variables de configuration remote.origin.url et remote.origin.fetch. (Voir git-config[1]).

STATUT DE SORTIE

En cas de succès, l’Ă©tat de sortie est 0.

Lorsque des sous-commandes telles que add, rename et remove ne trouvent pas le distant en question, l’Ă©tat de sortie est 2. Lorsque le distant existe dĂ©jĂ , l’Ă©tat de sortie est 3.

Pour toute autre erreur, l’Ă©tat de sortie peut ĂŞtre toute autre valeur non nulle.

EXEMPLES

  • Ajouter un nouveau distant, le rĂ©cupĂ©rer et en extraire une branche

    $ git remote
origin
$ git branch -r
  origin/HEAD -> origin/master
  origin/master
$ git remote add staging git://git.kernel.org/.../gregkh/staging.git
$ git remote
origin
staging
$ git fetch staging
...
From git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/staging
 * [new branch]      master     -> staging/master
 * [new branch]      staging-linus -> staging/staging-linus
 * [new branch]      staging-next -> staging/staging-next
$ git branch -r
  origin/HEAD -> origin/master
  origin/master
  staging/master
  staging/staging-linus
  staging/staging-next
$ git switch -c staging staging/master
...

  • Imiter git clone mais ne suivre que certaines branches sĂ©lectionnĂ©es

    $ mkdir project.git
$ cd project.git
$ git init
$ git remote add -f -t master -m master origin git://example.com/git.git/
$ git merge origin

VOIR AUSSI

git-fetch[1] git-branch[1] git-config[1]

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .

scroll-to-top