在UBUNTU 10上搭建GIT服务器

搭建git服务器有几种方式可选，gitosis是其中最常用的一种。

最近新装了ubuntu 10系统，并买了一块飞凌ok6410开发板，准备从零开始移植linux
2.6.28.6的内核，免不了要一步一步地添加和修改文件，所以最好有一个git repository来记录历史。

以前也一直用git来管理自己开发的一些软件，但都是最简单的单机方式，只用于做个记录，现在准备尝试一下更复杂也更标准的方式，建一个可以多机协作的，并且有正规的权限管理。

遇到一番周折，现在把过程详细记录一下。

总共分下面8个步骤，实施每个步骤的角色不同。

步骤0：区分不同角色/用户

有两个主机，一个名叫fion-laptop (ip: 192.168.0.100)，安装有ubuntu 10，是git
server所在的机器，是host端；另一个名叫fion-enc (ip: 192.168.0.101)，主要是windows
vista，安装virtual box虚拟机，其上运行ubuntu 9系统，这个系统主要是用来做测试，是remote端。

在安装过程里，总共有三个角色，分别是：

root@fion-laptop  – system root

fion@fion-laptop  – git administrator

git@fion-laptop   – git
repository holder

其中起主要做用的是fion@fion-laptop，它是git server的管理员。注意，git
server管理员不是名字叫git的那个用户。

步骤1：安装软件（root@fion-laptop实施）

安装下面三个软件包：

git, gitosis, openssh-server

其中openssh-server的配置文件是/etc/ssh/sshd_config，如果有修改的话，记得重启sshd服务：

/etc/init.d/ssh restart

步骤2：建立git用户（root@fion-laptop实施）

adduser git

步骤3: 生成管理员密钥对（fion@fion-laptop实施）

通过下面的命令生成密钥对

ssh-keygen -t rsa

刚刚生成的密钥放在~/.ssh目录下，其中id_rsa.pub是公钥，id_rsa是私钥。

公钥稍后需要给git用户使用，所以把它拷贝一份到/tmp目录下。

步骤4: 建立git仓库（git@fion-laptop实施）

登录git用户，回到自己的/home/git目录下，从/tmp目录拷贝fion的公钥id_rsa.pub。

运行下面命令：

gitosis-init < id_rsa.pub

生成两个目录：gitosis 和
repositories，后者即是git仓库所在位置。一个基本的仓库已经建立起来，下面需要做的全都是git管理员的配置工作。

生成repositories用的公钥是fion用户的，所以，现在fion已经是git仓库的管理员。

步骤5: 配置git server（fion@fion-laptop实施）

gitosis的配置方式很特别，repository的配置文件本身也是一个repository，名字是gitosis-admin.git。git
administrator需要把它clone一份到本地，然后修改和commit，当push回去的时候，新的配置就生效。

首先，已经是git administrator的fion用户运行：

git clone git@fion-laptop:gitosis-admin.git

在得到的gitosis-admin目录下有一个文本文件gitosis.conf和一个空目录keydir。

gitosis.conf里记录了repositories里的每一个group以及每个成员的权限，一个group就是一个repository。

比如我准备建立一个叫作ok6410的repository，就在gitosis.conf里添加以下内容：

[group ok6410]

writable = ok6410

members = fion@fion-laptop root@fion-laptop root@fion-enc

这里，我为ok6410这个repository设置了三个用户，一个是git的管理员，另外两个分别是fion-laptop和fion-enc两个主机上的root用户，这主要是因为我一般习惯于直接登录根用户来工作，当然这样比较危险，最好不要这样。

接下来要准备这三个用户的公钥。让他们分别通过ssh-keygen -t
rsa生成自己的密钥对，并设法把公钥拷贝到keydir目录下，分别重命名为fion@fion-laptop.pub
root@fion-laptop.pub root@fion-enc.pub

步骤6：创建新的repository（fion@fion-laptop实施）

依次通过以下命令来创建一个新的repository，即上面配置过的ok6410。

mkdir ok6410

cd ok6410

git init

git remote add origin git@fion-laptop:ok6410.git

…prepare some source code …

git add .

git commit -a

git push origin master:refs/heads/master

步骤7：测试（root@fion-enc）

在测试主机上尝试clone：

git clone git@192.168.0.100:ok6410.git

成功。

修改并commit、push，都成功。

注意事项：

在配置过程中遇到了几个问题，耽误了好些时间。强调一下，帮助其他人少走弯路：

1.步骤5中，配置文件中member的名字结构是name@host，其中host一定得是文本地址，不能直接用ip地址。可以在/etc/hosts
里设置ip地址与主机名的对应。比如root@192.168.0.101，这样设置的话，它对应的公钥文件名字必然是
root@192.168.0.101.pub，这个文件在push的时候会被警告。而且这名用户将无法clone成功。

2.还是与步骤5有关。一开始，我的测试用主机（virtual
box虚拟机）的虚拟网卡是采用的NAT方式，所以我把member设置为root@[vista主机IP]，因为我想git
server看到的地址一定是vista主机的地址。但这样也不行，clone失败。最后我把虚拟网卡改成桥接方式，git
server能直接看到虚拟机的IP，这样就成功了。

3.步骤6中，新创建的repository不能是空的，push的时候会报错，要多少放一点东西进去，哪怕是touch一个空文件。