git remotes

简单地说，一个remote repository是一个非本地的repo。它可以是在你公司网络上的另外一个git repo,也可以是在internet上，甚至在你本地文件系统中的一个repo,关键点是它和你的my-git-repo project是不同的。

我们已经知道branch在单个的repo中是如何组织你的工作流的，但是要知道branch本身在Git的跨repo分享commit也有重要作为。Remote branches和我们一直本地使用的local branch没有太多区别，他们仅仅代表着存在于另外一个repo中的一个branch而已。

这意味着我们可以利用我们branch的merging/rebasing技能很方便扩展到合作开发上去。下面我们假装在我们的样例web项目开发中有多个开发人员一起工作，他们是如何利用Git来协作的。

我们假设Mary，作为我们的graphic designer，她需要加入我们的web项目开发中。

Clone the Repository(MARY)

首先，mary需要一个她自己的repo以便可以开始工作。Git支持分布式的工作流，但是为了简便我们直接在本地文件系统中模拟不同repo协作。

cd /path/to/my-git-repo
cd ..
git clone my-git-repo marys-repo
cd marys-repo

上面的命令将在本地不同目录clone了一个my-git-repo项目repo，命名为marys-repo。

Configure The Repository (Mary)

首先，mary需要配置她clone的repo以便我们知道谁对项目做了贡献。

git config user.name "Mary"
git config user.email mary.example@rypress.com

注意由于我们没用--global选项，上面的user.name,email都只对这个repo有效，保存在.git的config文件中。

Start Mary’s Day (Mary)

今天，Mary开始开发她的bio page，她首先要在我们repo的clone repo中（对她来说，就是一个local repo)创建一个独立的分支以便隔离工作。

git checkout -b bio-page

Mary可以方便地在她的repo中创建和check out branches。她的repo是一个完全和我们的repo隔离的环境，她可以不用考虑任何在我们原始my-git-repo中的开发活动，任意地做她想做的开发工作。

就如branches是working directory的一种抽象，the staged snapshot, a commit history, a repository是一个branch的抽象。

Create Mary’s Bio Page ，commit，merge(Mary)

在marys-repo中，更改about/mary.html，随后commit该change到bio-page branch上，merge该branch到master上，以便准备分享mary自己的工作

git commit -a -m "Add bio page for Mary"
git log -n
git checkout master
git merge bio-page

现在我们项目repo和mary的repo是这样的：

注意：两个repo都有常见的，本地branches,两个repo之间还没有任何交互动作，所以我们没有看到remote branches.在切换到my-git-repo之前我们看看mary的remote connections:

View Remote Repositories (Mary)

git remote -v

Mary可以使用git remote命令列出她有哪些和其他repo之间的connections。明显地，她有一个被命名为origin的remote.注意，当你clone一个repo时，git自动增加一个指向original repo的remote，git预设你希望将来对这个cloned repo做协同。

Return to Your Repository (You)

注意这时你的repo中mary的bio page依然为空的。注意这个repo和mary repo是完全隔离的，这一点很重要。当她修改她的bio page时，我们可以在my-git-repo中做任何事情。我们甚至可以在我们的repo中修改她的bio page,而这将来在pull她的变动时就可能产生conflict.

Add Mary as a Remote (You)

在我们可以使用mary的bio page之前，我们需要访问她的repo.我们通过查看我们repo中的remote: git remote，你会发现我们还没有任何remote(注意我们没有做过任何clone,所以就不会有origin这个remote)，我们需要手工创建mary这个remote.

git remote add mary ../marys-repo
git remote -v

现在我们就可以使用mary来引用Mary的repo了(位置在../marys-repo) git remote add命令用于bookmark另外一个git repo以方便访问，我们两个repo之间的关联如下图：

既然我们的remote repository已经建立好了，我们下面将花时间探讨remote branches.

Fetch Mary’s Branches (You)

正如前面提过，我们可以使用remote branches来访问来自另外一个repo的snapshots。我们先看看我们当前的remote branches，使用：git branch -r命令，同样地，我们没有任何remote branch，为了获得这些remote branch list,我们需要fetch the branches from Mary's repository:

git fetch mary
git branch -r
将会输出：
mary/bio-page
mary/master

remote branch总是以<remote-name>/<branch-name>的形式列出，这样永远不会和local branches混淆。上面列出的remote branch反映了Mary的repo在执行fetch命令时的状态。但是注意如果Mary继续在她的repo中开发，那么我们fetch过来的状态并不会自动体现后面Mary的改动！这也就是说我们的remote branches本身并没有直接和Mary的repo链接起来，这意味着我们如果需要最新的Mary的update,必须再次执行fetch命令。

上面的途中显示了我们的repo的状态，我们已经可以访问Mary的snapshots(以方框指示）和她的branches，虽然我们没有一个实时的connection到Mary的repo。

Check Out a Remote Branch

我们可以在自己的repo中执行 git checkout mary/master来checkout一个remote branch以便检查review Mary's changes.

这个动作将会使我们的工作环境进入detached HEAD state,就像我们本地开发时checkout一个历史commit时的状态一样。这本身并不奇怪，因为我们的remote branches是Mary的branch的一个copy. checking out一个remote branch将会把我们的HEAD脱离local branch的tip,以下图来示例

红色方框为HEAD指向remote branch(mary的commit),local master则指向前一个commit。

如果我们不在local branch时，我们不能继续开发commit（我们可以检查代码）。为了能在mary/master上开发？？，我们需要将该branch merge到我们的local master或者再创建另外一个分支。

Find Mary’s Changes

我们可以使用本地repo操作一样的log-filtering语法来查看Mary's changes.

git log master..mary/master --stat

这将不会有任何输出，因为自从Mary clone了repo后，我们并未做改变，换句话说，我们的历史还没有发散，我们只是落后一个commit。

Merge Mary’s Changes

我们来apprvoe Mary的变更并且集成到我们的master branch上去。

git checkout master
git merge mary/master

虽然mary/master是一个remote branch,这仍然会产生一个fast-forward merge,因为从我们的local master到mary/master的tip之间是linear path。在merge之后，Mary remote branch上的snapshots称为我们local master branch的一部分，比较merge前后的情况示意如下：

注意，虽然我们可以访问到她的bio-page分支，但是我们仅仅和Mary的master branch做了交互。

Push a Dummy Branch

为了对我们的git fetch命令做一个补充，我们看看pushing命令。Fetching和pushing几乎是相反的，fetching imports branches,而pushing exports branches to another repo.比如：

git branch dummy
git push mary dummy

上面的命令创建一个dummy branch，随后发送到Mary的repo中，我们切换到Mary的repo看看我们干过什么：

cd ../marys-repo
git branch

你会发现一个新的dummy branch在她的local branch listing.我说过git fetch和git push几乎是相反的是因为pushing创建一个local branch,而fetching却imports commits into remote branches!!

现在我们站在Mary的角度上来看，当她在她自己的repo中开发时却突然发现莫名其妙多了一个dummy branch在她的local branch list中，这是不是很唐突混乱？明显的，push branch到其他人的repo中将会造成workflow混乱。因此，作为一个general rule，你永远不要push你的本地变更到别的开发人员的repo中！！但是，我们到底应该如何使用push呢？

在下面的文章中，我将描述push操作对于维护public repo是非常有必要的！

Push a New Tag

git push的一个重要特性是git push不会自动push和一个branch关联的tags。我们做下面的实验：

git tag -a v2.0 -m "An even stabler version of the website"

git push mary master

git push mary v2.0

通过上面的命令，你将可以在Mary的repo中看到一个v2.0 tag。注意：非常容易你可能虽然创建了一个tag,却忘记push！如果你的项目缺少一两个tag，那么很大的可能是你忘记push到remote repo了！

有一点需要谨记： remotes are for people, branches are for topic! 不要为了你的每一个开发人员创建一个独立的分支，而应该给他们独立的repo并且使用git remote add来引用。Branches总是用来做项目开发的，不是用来管理用户的。