# 4.2\. 共享版本库
除了独具特色的“Fork + Pull”的分布式工作模式,GitHub同样支持传统的集中式协同工作模式。
## 4.2.1\. 版本库授权
GitHub可以通过多种途径为版本库授权,让版本库成为多人共享的版本库,从而让项目管理者围绕项目创建一个核心开发团队。下面以gotgithub账号下的helloworld版本库为例,介绍如何设置版本库的多人共享。
进入gotgithub/helloworld项目的管理界面,点击左侧导航条中的“Collaborators”,可以查看及添加项目的合作者,如图4-17所示。
[![../images/collaborators.png](http://www.worldhello.net/gotgithub/images/collaborators.png)](https://box.kancloud.cn/2015-07-09_559de3b2167d2.png)
图4-17:添加项目合作者
图4-17为项目添加了两个合作者:supergirl和incredible。添加到项目当中的合作者会收到通知邮件,告知已经被加入到相应的项目当中。当新加入的项目合作者,如incredible,登录GitHub,在仪表板的版本库列表中会看到源自gotgithub用户的版本库,如图4-18所示。
[![../images/prj-list-of-collab.png](http://www.worldhello.net/gotgithub/images/prj-list-of-collab.png)](https://box.kancloud.cn/2015-07-09_559de3b46988d.png)
图4-18:合作者项目列表
从图4-18可以看出GitHub用户incredible自己创建的项目托管在自己的空间下,而作为合作者参与的项目仍然托管在原创建者(gotgithub)的空间下,这一点明显和派生(Fork)而来的项目不同。图4-19是以incredible登录GitHub访问gotgithub/helloworld的界面。
[![../images/collab-view-helloworld.png](http://www.worldhello.net/gotgithub/images/collab-view-helloworld.png)](https://box.kancloud.cn/2015-07-09_559de3bab97ed.png)
图4-19:以合作者身份访问项目
用户incredible对版本库gotgithub/helloworld拥有写入权限。和gotgithub用户稍有区别的是没有管理员权限。
## 4.2.2\. 与传统集中式工作模式的异同
传统的集中式版本控制系统,如CVS、SVN,所有用户都访问同一个版本库。采用集中式工作模式的GitHub用户也同样是访问同一版本库。
对于由用户gotgithub创建的helloworld版本库,添加了合作者supergirl和incredible,三个人克隆版本库使用如下命令。
* 用户 gotgithub 克隆版本库。
```
gotgithub$ git clone https://gotgithub@github.com/gotgithub/helloworld.git
```
* 用户 supergirl 克隆版本库。
```
supergirl$ git clone https://supergirl@github.com/gotgithub/helloworld.git
```
* 用户 incredible 克隆版本库。
```
incredible$ git clone https://incredible@github.com/gotgithub/helloworld.git
```
传统集中式版本控制系统,所有的提交历史数据都在唯一的版本库中,各个提交是顺序进行的。为了防止多用户在提交时相互覆盖,集中式版本控制系统发明了很多方法 。有的采用编辑锁的形式(如VSS),更改文件前对文件锁定,其他人禁止对文件进行访问(甚至无法读取),完成修改并提交后,文件解锁。有的如SVN,允许多人同时编辑同一文件,但只有先进行提交的才能成功,后提交的会遇到“过时”错误,必须先获取版本库中的新增提交并和本地修改进行合并。即传统集中式版本控制系统,提交时必须和唯一的版本库所在的服务器保持连接,而且提交有可能会失败。
对于像Git这样的分布式版本控制系统,提交总是会成功,这是因为提交并不涉及和共享服务器的交互,是针对本地克隆版本库进行的本地操作。采用集中式的工作模式,共享版本库作为各个用户各自本地版本库数据交换、沟通的中介,只有在本地克隆版本库需要和共享版本库同步的时候才要和服务器建立连接。例如将本地所做的一个或多个提交推送到共享服务器,或者将服务器上新的提交获取到本地克隆版本库。
实际上无论采用分布式还是集中式的工作模式,Git都好像工作在一个独立的分支上(克隆即分支),即使共享版本库和本地克隆版本库的分支名都叫做master。如图4-20,三个用户克隆gitgithub/helloworld版本库后,各自在本地执行了一次或多次提交。
[![../images/workflow-commit.png](http://www.worldhello.net/gotgithub/images/workflow-commit.png)](https://box.kancloud.cn/2015-07-09_559de3c7342f4.png)
图4-20:在本地版本库中的提交
三个用户各自的提交都会非常顺利,但是一旦决定将本地提交推送到共享服务器时就可能遇到麻烦。用户 gotgithub 先执行推送,会非常顺利。如图4-21所示。
```
gotgithub$ git push
```
[![../images/workflow-commit-push.png](http://www.worldhello.net/gotgithub/images/workflow-commit-push.png)](https://box.kancloud.cn/2015-07-09_559de3d282ab3.png)
图4-21:用户gotgithub完成推送
而其他人就没有这么幸运了,会报告错误:遇到非快进式推送。Git的推送操作就像SVN等集中式版本控制系统的提交操作那样,先执行者成功,后执行者糟糕(要解决冲突,自动或手动)。
## 4.2.3\. 合并后推送
当用户gotgithub完成推送后,共享版本库以及三个用户的本地版本库如图4-21所示。其中共享版本库变得和gotgithub用户的本地版本库相一致。此时如果用户supergirl执行推送,会遇到错误:非快进式推送。
```
supergirl$ git push
To https://supergirl@github.com/gotgithub/helloworld.git
! [rejected] master -> master (non-fast-forward)
error: failed to push some refs to 'https://supergirl@github.com/gotgithub/helloworld.git'
To prevent you from losing history, non-fast-forward updates were rejected
Merge the remote changes (e.g. 'git pull') before pushing again. See the
'Note about fast-forwards' section of 'git push --help' for details.
```
GitHub并不对强制推送进行限制,但是用户supergirl不要用git push -f命令强制推送,因为那样会覆盖掉共享版本库中用户gotgithub的推送,正确的做法是获取共享版本库中新提交,并在本地版本库中和本地提交合并。即执行:
```
supergirl$ git fetch
supergirl$ git merge
```
获取和合并操作过程如图4-22所示。
[![../images/workflow-fetch-merge.png](http://www.worldhello.net/gotgithub/images/workflow-fetch-merge.png)](https://box.kancloud.cn/2015-07-09_559de3dd73137.png)
图4-22:合并操作示意图
实际上用户supergirl只需执行一条命令便可完成所有的操作:
```
supergirl$ git pull
```
即:git pull = git fetch + git merge。
但是合并操作并不总是会成功,如果自动合并失败,会在暂存区对合并前后文件进行标识,工作区进入冲突解决状态,在冲突解决完成之前不能提交。Git支持多种图形工具帮助完成冲突解决,执行如下命令,即可自动调用已安装的冲突解决工具。
```
supergirl$ git mergetool
```
冲突解决完毕,执行提交即完成冲突解决。如果在冲突解决过程把本地文件搞得一团糟,随时可以取消合并操作。执行命令git reset --hard会取消冲突的合并让本地版本库回到合并之前的状态。
成功完成合并后将本地版本库中的提交推送到共享版本库:
```
supergirl$ git push
```
完成推送后的版本库示意图如图4-23所示。
[![../images/workflow-merge-push.png](http://www.worldhello.net/gotgithub/images/workflow-merge-push.png)](https://box.kancloud.cn/2015-07-09_559de3df8d8d4.png)
图4-23:完成合并后推送
## 4.2.4\. 合并还是变基
合并并非多个开发者的工作成果融合的唯一选择,有时甚至并非最佳选择。一方面合并会产生除了合并双方(或多方)所有提交外的一个新提交,增加了代码审核的负担,另一方面本地多个提交混杂一起与远程分支合并会更困难。在特定情况下,变基是合并之外的另一个选择。
图4-24展示用户incredible采用合并和变基两种不同解决方案的操作结果。图中右上是合并操作后的结果,右下是变基操作后的结果。
[![../images/workflow-merge-or-rebase.png](http://www.worldhello.net/gotgithub/images/workflow-merge-or-rebase.png)](https://box.kancloud.cn/2015-07-09_559de3e13b28d.png)
图4-24:合并和变基结果比较
若用户 incredible 选择变基操作,执行命令如下:
* 获取远程版本库的提交到本地的远程分支。
```
incredible$ git fetch origin
```
* 执行变基操作,将本地master分支的提交变基到新的远程分支中。
```
incredible$ git rebase origin/master
```
如果一切顺利,变基后推送到共享版本库。
```
incredible$ git push
```
推送后的版本库状态如图4-25所示。
[![../images/workflow-rebase-push.png](http://www.worldhello.net/gotgithub/images/workflow-rebase-push.png)](https://box.kancloud.cn/2015-07-09_559de3e2b8a4f.png)
图4-25:变基后推送
如果希望在执行git pull时自动使用git rebase取代默认的git merge操作,可以在git pull命令行添加参数--rebase如下:
```
$ git pull --rebase
```
或者通过配置变量设置当前分支使用变基策略,即每次执行git pull命令时对于master分支,采用变基操作取代默认的合并操作。
```
$ git config branch.master.rebase true
```
如果希望本地所有克隆版本库在执行git pull时都改变默认行为,将变基作为首选,则如下设置全局变量。
```
$ git config --global branch.autosetuprebase true
```
- 前言
- 1. 探索GitHub
- 1.1. 什么是GitHub
- 1.2. GitHub亮点
- 1.3. 探索GitHub
- 2. 加入GitHub
- 2.1. 创建GitHub账号
- 2.2. 浏览托管项目
- 2.3. 社交网络
- 3. 项目托管
- 3.1. 创建新项目
- 3.2. 操作版本库
- 3.3. 公钥认证管理
- 3.4. 版本库钩子扩展
- 3.5. 建立主页
- 4. 工作协同
- 4.1. Fork + Pull模式
- 4.2. 共享版本库
- 4.3. 组织和团队
- 4.4. 代码评注
- 4.5. 缺陷跟踪
- 4.6. 维基
- 5. 付费服务
- 5.1. GitHub收费方案
- 5.2. GitHub企业版
- 6. GitHub副产品
- 6.1. GitHub:Gist
- 6.2. 其他版本控制工具支持
- 6.2.1. 用SVN操作GitHub
- 6.2.2. 用Hg操作GitHub
- 6.3. 客户端工具
- 6.4. 其他
- 7. 附录:轻量级标记语言
- 贡献者列表