git-remote

原文: https://git-scm.com/docs/git-remote

名称

git-remote - 管理一组跟踪的存储库

概要

git remote [-v | --verbose]
git remote add [-t <branch>] [-m <master>] [-f] [--[no-]tags] [--mirror=<fetch|push>] <name> <url>
git remote rename <old> <new>
git remote remove <name>
git remote set-head <name> (-a | --auto | -d | --delete | <branch>)
git remote set-branches [--add] <name> <branch>…​
git remote get-url [--push] [--all] <name>
git remote set-url [--push] <name> <newurl> [<oldurl>]
git remote set-url --add [--push] <name> <newurl>
git remote set-url --delete [--push] <name> <url>
git remote [-v | --verbose] show [-n] <name>…​
git remote prune [-n | --dry-run] <name>…​
git remote [-v | --verbose] update [-p | --prune] [(<group> | <remote>)…​]

描述

管理您跟踪其分支的存储库集(“远程”)。

OPTIONS

 -v 
 --verbose 

稍微冗长一点,并在名字后显示远程网址。注意:必须放在remotesubcommand之间。

COMMANDS

没有参数,显示现有遥控器的列表。有几个子命令可用于对遥控器执行操作。

 add 

添加名为&lt; name&gt;的远程名称对于&lt; url&gt;的存储库。然后,命令git fetch &lt;name&gt;可用于创建和更新远程跟踪分支&lt; name&gt; /&lt; branch&gt;。

使用-f选项,在设置远程信息后立即运行git fetch &lt;name&gt;

使用--tags选项,git fetch &lt;name&gt;从远程存储库导入每个标记。

使用--no-tags选项,git fetch &lt;name&gt;不会从远程存储库导入标记。

默认情况下,仅导入已获取分支上的标记(请参阅 git-fetch [1] )。

使用-t &lt;branch&gt;选项,而不是默认的glob refspec用于远程跟踪refs/remotes/&lt;name&gt;/命名空间下的所有分支,而是创建仅跟踪&lt;branch&gt;的refspec。您可以提供多个-t &lt;branch&gt;来跟踪多个分支而不占用所有分支。

使用-m &lt;master&gt;选项,symbolic-ref refs/remotes/&lt;name&gt;/HEAD被设置为指向远程的&lt;master&gt;分支。另请参见set-head命令。

使用--mirror=fetch创建获取镜像时,refs不会存储在 refs / remotes / 命名空间中,而是遥控器上 refs / 中的所有内容都将被直接镜像进入本地存储库中的 refs / 。此选项仅在裸存储库中有意义,因为获取将覆盖任何本地提交。

使用--mirror=push创建推镜时,git push将始终表现为--mirror通过。

 rename 

重命名名为&lt; old&gt;的远程名称到&lt; new&gt;。将更新远程的所有远程跟踪分支和配置设置。

如果&lt; old&gt;和&lt; new&gt;是相同的,&lt; old&gt;是$GIT_DIR/remotes$GIT_DIR/branches下的文件,远程转换为配置文件格式。

 remove 
 rm 

删除名为&lt; name&gt;的远程数据库。将删除远程的所有远程跟踪分支和配置设置。

 set-head 

设置或删除指定远程的默认分支(即symbolic-ref refs/remotes/&lt;name&gt;/HEAD的目标)。不需要具有远程的默认分支,但允许指定远程的名称来代替特定分支。例如,如果origin的默认分支设置为master,则可以在通常指定origin/master的任何位置指定origin

使用-d--delete,删除符号ref refs/remotes/&lt;name&gt;/HEAD

使用-a--auto,查询远程以确定其HEAD,然后将symbolic-ref refs/remotes/&lt;name&gt;/HEAD设置为同一分支。例如,如果远程HEAD指向next,“git remote set-head origin -a”将symbolic-ref refs/remotes/origin/HEAD设置为refs/remotes/origin/next。这仅在refs/remotes/origin/next已存在时才有效;如果不是,它必须先取出。

使用&lt;branch&gt;显式设置symbolic-ref refs/remotes/&lt;name&gt;/HEAD。例如,“git remote set-head origin master”将symbolic-ref refs/remotes/origin/HEAD设置为refs/remotes/origin/master。这仅在refs/remotes/origin/master已存在时才有效;如果不是,它必须先取出。

 set-branches 

更改命名远程跟踪的分支列表。在初始设置遥控器之后,这可用于跟踪可用远程分支的子集。

命名分支将被解释为使用 git remote add 命令行上的-t选项指定。

使用--add,而不是替换当前跟踪的分支列表,添加到该列表。

 get-url 

检索远程的URL。这里扩展了insteadOfpushInsteadOf的配置。默认情况下,仅列出第一个URL。

使用--push,将查询推送URL而不是提取URL。

使用--all,将列出远程的所有URL。

 set-url 

更改远程的URL。设置远程&lt; name&gt;的第一个网址匹配正则表达式&lt; oldurl&gt; (如果没有给出&lt; oldurl&gt;则是第一个URL)到&lt; newurl&gt;。如果&lt; oldurl&gt;与任何URL都不匹配,发生错误并且没有任何更改。

使用--push,操纵推送URL而不是获取URL。

使用--add,不添加现有URL,而是添加新URL。

使用--delete,而不是更改现有网址,所有匹配正则表达式&lt; url&gt;的网址已删除远程&lt; name&gt;。尝试删除所有非推送URL是一个错误。

请注意,推送URL和提取URL即使可以设置不同,仍必须引用相同的位置。您推送到推送URL的内容应该是您从提取URL中立即获取的内容。如果您尝试从一个位置(例如您的上游)获取并推送到另一个位置(例如您的发布存储库),请使用两个单独的遥控器。

 show 

提供有关远程&lt; name&gt;的一些信息。

使用-n选项,不会先使用git ls-remote &lt;name&gt;查询远程磁头;而是使用缓存的信息。

 prune 

删除与&lt; name&gt;关联的陈旧引用。默认情况下,&lt; name&gt;下的过时远程跟踪分支被删除,但根据全局配置和远程配置,我们甚至可以修剪那些尚未推送的本地标签。相当于git fetch --prune &lt;name&gt;,但不会获取新的引用。

请参阅 git-fetch [1] 的PRUNING部分,了解它将根据各种配置进行修剪的内容。

使用--dry-run选项,报告将修剪哪些分支,但不实际修剪它们。

 update 

获取由远程数据库定义的存储库中的远程数据库或远程组的更新。&lt; group&gt;。如果在命令行中既未指定group也未指定remote,则将使用配置参数remotes.default;如果未定义remotes.default,则所有没有配置参数remote的遥控器将被更新。&lt; name&gt; .skipDefaultUpdate设置为true。 (参见 git-config [1] )。

使用--prune选项,对所有已更新的遥控器运行修剪。

讨论

使用remote.origin.urlremote.origin.fetch配置变量实现远程配置。 (参见 git-config [1] )。

例子

  • 添加一个新的远程,获取,并从中检出一个分支

    $ git remote
    origin
    $ git branch -r
      origin/HEAD -&gt; 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     -&gt; staging/master
     * [new branch]      staging-linus -&gt; staging/staging-linus
     * [new branch]      staging-next -&gt; staging/staging-next
    $ git branch -r
      origin/HEAD -&gt; origin/master
      origin/master
      staging/master
      staging/staging-linus
      staging/staging-next
    $ git checkout -b staging staging/master
    ...
    
  • 模仿 git clone 但仅跟踪选定的分支

    $ 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
    

也可以看看

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

GIT

部分 git [1] 套件