跟踪多个 Git 远程仓库

拥有一致的命名标准是保持本地和上游 Git 仓库保持一致的关键。

当本地 Git 仓库的命名与远程仓库不一致时，与远程仓库协作就会变得很混乱。

解决此问题的一个方法是标准化两个词的使用和含义： origin 指的是你个人的  example.com/<USER>/* 仓库，而  upstream 指的是你从  origin 仓库 复刻 fork 出来的  example.com 仓库。换句话说， upstream 指的是公开提交工作的上游仓库，而  origin 指的是你对上游仓库的本地复刻，例如，你从这里生成 拉取请求 pull request （PR）。

以 pbench 仓库为例，下面是一个逐步建立新的本地克隆的方法，其中  origin 和  upstream 的定义是一致的。

1、在大多数 Git 托管服务上，当你想在上面工作时，必须对它进行复刻。当你运行自己的 Git 服务器时，这并不是必要的，但对于一个公开的代码库来说，这是一个在贡献者之间传输差异的简单方法。

创建一个 Git 仓库的复刻。在这个例子中，假设你的复刻位于 example.com/<USER>/pbench 。

2、接下来，你必须获得一个统一资源标识符 （ URI ），以便通过 SSH 进行 克隆 cloning 。在大多数 Git 托管服务上，比如 GitLab 或 GitHub，它在一个标有 “Clone” 或 “Clone over SSH” 的按钮或面板上，可以将克隆 URI 复制到剪贴板中。

3、在你的开发系统中，使用你复制的 URI 克隆仓库：

$git clone [email protected]:<USER>/pbench.git

这将以默认名称 origin 来克隆 Git 仓库，作为你的  pbench 仓库复刻副本。

4、切换到刚才克隆的目录：

$cd ~/pbench

5、下一步，获取源仓库的 SSH URI（你最初复刻的那个）。这可能和上面的方法一样。找到 “Clone” 按钮或面板，复制克隆地址。在软件开发中，这通常被称为“上游”，因为（理论上）这是大多数提交发生的地方，而你打算让这些提交流向下游的仓库。

6、将 URI 添加到你的本地仓库中。是的，将有 两个不同 的远程仓库分配给你的本地仓库副本：

$git remote add upstream [email protected]:bigproject/pbench.git

7、现在你有两个命名远程仓库： origin 和  upstream 。 你可以用  remote 子命令查看你的远程仓库：

$git remote-v

现在，你的本地 master 分支正在跟踪  origin 的  master ，这不一定是你想要的。你可能想跟踪这个分支的  upstream 版本，因为大多数开发都在上游进行。这个想法是，你要在从上游获得的内容的基础上添加更改。

8、将你的本地的 master 分支改成跟踪  upstream/master ：

$git fetch upstream
$git branch--set-upstream-to=upstream/master master

你可以对任何你想要的分支这样做，而不仅仅是 master 。例如，有些项目使用  dev 分支来处理所有不稳定的变化，而将  master 保留给已批准发布的代码。

9、一旦你设置了你的跟踪分支，一定要变基（ rebase ）你的  master 分支，使它与上游仓库的任何新变化保持一致：

$ git remote update
$ git checkout master
$ git rebase

这是一个保持 Git 仓库在不同复刻之间同步的好方法。如果你想自动完成这项工作，请阅读 Seth Kenlon 关于 使用 Ansible 托管 Git 仓库 的文章。