在centos上搭建git服务器

http://blog.youkuaiyun.com/hacky_way/article/details/9191715

0.定义

      这里的示例中出现的主机有三台：localhost是一台centos主机，也是git服务器；ubuntu是git服务器管理员的workstation；linux是某个git用户jason的workstation。

    localhost即git服务器上出现了两个账户test和git，test是用来搭建git服务器的已存在账户，git是为git服务器创建的专有账户。

    ubuntu是git服务器管理员的workstation，该管理员在自己的这台workstation上的账户是user。

    linux是jason的workstation。

git server:                 [test@localhost]     [git@localhost]

git administrator:      [user@ubuntu]

git user:                    [jason@linux]

    文中省略了ssh在各主机间的登录命令及scp复制公钥的过程，注意观察命令前的用户及主机名提示即可。

1.安装git

1. [test@localhost ~]$ sudo yum install git  

      检查git是否安装正确

1. [test@localhost ~]$ git --version  
2. git version 1.7.1  

2.为git服务器创建专有用户

      通常将该用户取名git

1. [test@localhost ~]$ sudo useradd git -d /home/git  

    最后切换到git用户

1. [test@localhost ~]$ su - git  

3.安装gitolite

        gitolite是一款git服务管理工具，通过公钥对用户进行认证，并能够利用配置文件进行repo的精细授权管理。由于它采用ssh公钥认证，所以先要安装ssh。

1. [test@localhost ~]$ sudo yum install ssh  
2. [test@localhost ~]$ sudo service sshd start  
3. [test@localhost ~]$ sudo chkconfig sshd on  

    然后准备安装gitolite，git服务器的管理员需要先准备自己的密钥对。所以，假设这个管理员在自己的workstation（另一台linux主机，这里只是为了得到管理员自己的密钥，并非一定要在另一台linux机器上）上，他需要创建自己的密钥对（方便起见，不要输入passphrase）：

1. [user@ubuntu ~]$  ssh-keygen -f ~/.ssh/admin  

        该命令在~/.ssh目录下创建密钥对admin和admin.pub。

    现在回到git服务器主机，将刚创建的admin.pub复制到git用户的家目录下，即/home/git/下，并且chown为git账户。另外，在安装前须保证不存在文件~/.ssh/authorized_keys或该文件为空。

    安装gitolite：

1. [git@localhost ~]$ git clone git://github.com/sitaramc/gitolite  
2. [git@localhost ~]$ mkdir -p ~/bin  
3. [git@localhost ~]$ gitolite/install -to ~/bin  
4. [git@localhost ~]$ gitolite setup -pk admin.pub  

   如果在执行第三条命令时出现错误：

Can't locate Time/HiRes.pm in @INC (@INC contains: /home/git/gitolite/src/lib /usr/local/lib/perl5 /usr/local/share/perl5 /usr/lib/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib/perl5 /usr/share/perl5 .) at /home/git/gitolite/src/lib/Gitolite/Common.pm line 76.
BEGIN failed--compilation aborted at /home/git/gitolite/src/lib/Gitolite/Common.pm line 76.
Compilation failed in require at gitolite/install line 15.
BEGIN failed--compilation aborted at gitolite/install line 15.

    说明缺少perl需要的软件Time::HiRes，安装该软件包后，重新执行上面的命令：

1. [test@localhost ~]$ sudo yum install perl-Time-HiRes  

4.添加用户

    现在，假设team里有个成员叫jason，他将自己的公钥jason.pub邮件给管理员，要求为他创建一个名为foo的repo，他要求该repo仅自己可以修改，其他人不能修改但可以查看。首先管理员在自己的workstation上先要获取gitolite的管理repo，the_git_host是管理员刚搭建的git服务器地址：

1. [user@ubuntu ~]$  git clone git@the_git_host:gitolite-admin  

    注意，执行该命令时，如果被要求输入密码，说明前面某些配置出错了，需要重新查证后再继续。

   克隆完成后，在./gitolite-admin目录下需要关注两个子目录：conf和keydir。conf是gitolite的权限配置文件夹，keydir用于放置所有用户的公钥。所以，现在可以将jason的公钥jason.pub放入文件夹keydir。然后编辑conf/gitolite.conf文件，在文件末尾添加新的repo：

1. repo foo  
2.             RW+         =   jason  
3.             R           =   @all  

    提交更改，完成用户及其库的添加：

1. [user@ubuntu ~]$  git add conf  
2. [user@ubuntu ~]$  git add keydir  
3. [user@ubuntu ~]$  git commit -m 'added foo, gave access to jason'  
4. [user@ubuntu ~]$   git push  

5.用户执行git版本管理

1. [jason@linux ~]$   git clone git@the_git_host:foo  

      命令执行完成，创建一个空库foo，现在jason就可以进行版本管理，在需要的时候进行提交。

    如果用户想要查询自己有权访问的所有repo，可以使用下面命令查询：

1. [jason@linux ~]$ ssh git@the_git_host  info  

    注意：从第3步开始，任何地方使用 ssh或git登录到git服务器需要输入密码，都说明配置git服务器出现错误，需要重新安装gitolite，重新安装前先清除之前的文件 ：

1. [git@localhost ~]$ ls -a | grep gitolite | xargs rm -fr  
2. [git@localhost ~]$ rm -fr ~/repositories ~/bin  ~/projects.list ~/.ssh/authorized_keys  

6.配置gitweb

    如果想要能够在网页上访问git库，就可以利用gitweb。

1. [test@localhost ~]$ sudo yum install gitweb  

      打开/etc/gitweb.conf文件，按照注释的格式添加projectroot变量，指向git库：

1. our  $projectroot = "/home/git/repositories";  
2. our @git_base_url_list = qw(git://git.the_git_host  
3.                             ssh://git.the_git_host/var/lib/git);  

      最后编辑apache服务器配置文件/etc/httpd/conf/httpd.conf，在文末添加：

1. <VirtualHost *:80>  
2.     ServerName the_git_host  
3.     DocumentRoot /var/www/git  
4.     <Directory /var/www/git>  
5.         Options ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch  
6.         AllowOverride All  
7.         order allow,deny  
8.         Allow from all  
9.         AddHandler cgi-script cgi  
10.         DirectoryIndex gitweb.cgi  
11.     </Directory>  
12. </VirtualHost>  

      最后修改git库的权限，否则会出现404 no projects found错误，最后重启Apache服务器：

1. [test@localhost ~]$ sudo chmod 775 /home/git/repositories  
2. [test@localhost ~]$ sudo chmod 775 /home/git  
3. [test@localhost ~]$ sudo apachectl restart  

     最后在浏览器里键入http://the_git_host就可以看到git库了，我在本机测试，使用的是http://localhost


      注：如果在完成上述操作后，仍然显示404 no project found，那很可能又是SELinux惹的麻烦，尝试更改selinux的状态为permissive后再刷新页面试试：

1. [test@localhost ~]$ sudo setenforce 0  

7.参考文献

1.gitolite

2.gitweb