Git服务器在Ubuntu中的搭建

 公司最近准备启用git来管理公司项目，在CTO张头的带领下，历经挫折，终于完成了git服务器的配置工作。在使用Git之前，大家首先要明确几个概念：git服务器、git客户端和git服务器管理员。本文中使用ubuntu当作git服务器，pcA和pcB分别作为服务器管理员和git客户端。通常，git服务器上需要安装OpenSSH Server、Git、Gitosis和Apache2(如果想使用Gitweb的话)。

    本文将主要介绍git服务端和管理员相关的一些配置方法，客户端及管理员的git操作方法将在另一篇文章中作详细介绍。

(一)   Git服务端

1.请使用apt-get update和apt-get upgrade命令更新当前系统，如果不更新，在后面安装一些程序的时候可能会出现某些依赖包没安装的现象。

 

2.安装OpenSSH Server（ ubuntu） (当前用户为wirror800)

    首先，使用ps -e|grep ssh命令，检查本机上是否已经运行ssh服务。如果没有，继续；否则，跳过此步骤。

    执行命令：

    sudo apt-get install openssh-server

 

3.修改ssh服务端配置文件 /etc/ssh/sshd_config (当前用户为wirror800)

   Port 22 # 修改成你想要的登陆端口,如2222

   PermitRootLogin no # 禁止root用户登陆

   StrictModes yes # 检查密钥的用户和权限是否正确，默认打开的

   RSAAuthentication yes # 启用 RSA 认证

   PubkeyAuthentication yes # 启用公钥认证

   PasswordAuthentication no # 禁止密码认证，默认是打开的

   ServerKeyBits 1024 # 修改后变为此状态，将ServerKey强度改为1024比特

   PermitEmptyPasswords no # 修改后变为此状态，禁止空密码进行登录

 

   修改完成后，重启ssh服务：

   sudo /etc/init.d/ssh restart

   注意：至此，服务端SSH的操作就已经结束了。网上说的“ id_rsa文件拷贝到Client端的~/.ssh/目录下，将id_rsa.pub拷贝到

Server端的~/.ssh/目录下，改名为authorized_keys ”其实都是不准确的。id_rsa是使用 ssh-keygen生成的rsa私钥， id_rsa.pub

是同时生成的公钥，服务器端通信使用的秘钥可以应该由服务器管理员来创建和管理，如果你想把当前用户wirror800作为管理

员也是可以的，相关管理员的操作见本文第二部分。不推荐在ubuntu服务器端建立管理员帐号。

    建议大家参考一下OpenSSH的相关内容：http://www.freebsd.org/doc/zh_CN/books/handbook/openssh.html

 

4.安装git (当前用户为wirror800)

    sudo apt-get install git-core

    安装git过程中可能会遇到一些依赖包下载失败的情况，主要是由于ubuntu的中文站点访问的问题，我们可以到其英文站点

上下载相关文件并进行手动安装。给大家一个链接地址：

     http://archive.ubuntu.com/ubuntu/pool/main/

 

5.安装gitosis(为什么要使用gitosis是大家首先需要明确的问题) (当前用户为wirror800)

    (1)在你喜欢的位置下，新建一个文件夹，用来存放下载的gitosis文件，如

    mkdir ~/gitosis_setup

    (2)安装gitosis

    cd ~/ gitosis_setup

    git clone git://eagain.net/gitosis

    cd gitosis

    sudo python setup.py install

    注意：如果python setup.py install失败，需要安装python-setuptools.py

    sudo apt-get install python-setuptools.py

 

6. 为gitosis创建系统用户 (当前用户为wirror800)

     sudo adduser --system --shell /bin/sh --gecos ''git SCM user'' --group --disabled-password --home /home/git  git

     这种方法是网上比较常见的方法，创建的是一个禁用密码的git用户，但在使用su命令切换git用户的时候，空密码老是

验证失败，大家可以使用下面的方法来创建git用户：

      sudo useradd -m git

      sudo password git

 

7. 运行gitosis(当前用户为wirror800)

      (1)将管理员生成的公钥上传或拷贝到服务器上。这里的公钥需要在git服务器管理员下使用ssh-keygen -t rsa命令来创建，

网上流传的方法是scp /your pub_path/id_rsa.pub ${SERVER_IP}:id_rsa.pub。我们这里使用的是直接U盘拷贝的方法。

      (2)初始化gitosis

      进入到拷贝过来的id_rsa.pub所在目录：cd /tmp

      sudo chmod 777 id_rsa.pub

      sudo -H -u git gitosis-init < id_rsa.pub (或者切换到git用户下执行gitosis-init < id_rsa.pub也可以，记得exit切换回当前用户)

      此时，会在/home/git目录下生成一些目录，如果想要别人能够clone gitosis-admin.git，需要执行以下操作：

      sudo chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update

 至此，gitosis的安装工作已完成，其相关配置可以有管理员来操作，然后再提交到服务器上。以下是关于gitweb的安装配置，

不需要的同学，请跳过下面的8～10步。

 

8.安装gitweb (当前用户为wirror800)

   sudo apt-get install gitweb

 

9.安装apache2

  sudo apt-get install apache2

 

10.配置gitweb (当前用户为wirror800) 
(1)默认没有 css 加载，把 gitweb 要用的静态文件连接到 DocumentRoot 下：
   cd /var/ www/ 
   sudo ln -s / usr/ share/ gitweb/* .

   (注意后面的点)

(2)修改配置：

   sudo vi /etc/ gitweb.conf

   将 $projectroot 改为gitosis-admin.git所在目录： /home/git/repositories

 (3)修改 /home/git/repositories权限，默认情况下，gitosis将 repositories权限设置为不可读的

    sudo chmod 777 -R /home/git/repositories

 

11.编辑apache2配置文件，建立web站点 (当前用户为wirror800，默认情况下可以忽略此步骤)

(1) 编辑apache2配置文件

    ubuntu中默认的web目录是/var/www，默认的cgi目录是 /usr/lib/cgi-bin/,安装完成gitweb后，gitweb的gitweb.cgi会自动放置

到该目录下。如果你的cgi路径不是默认的/usr/lib/cgi-bin/，需要将gitweb安装在/usr/lib/cgi-bin中的gitweb.cgi复制到原来配置

的cgi-bin路径，并修改apache的配置文件/etc/apache2/apache.conf：

    SetEnv  GITWEB_CONFIG   /etc/gitweb.conf
    gitweb.conf配置文件形如：(可自行修改，这里不做详细介绍)
<Directory "/srv/www/cgi-bin/gitweb">           
      Options FollowSymlinks ExecCGI          
      Allow from all                          
      AllowOverride all                       
      Order allow,deny                        

      <Files gitweb.cgi>
           SetHandler cgi-script
      </Files>                    
      RewriteEngine on
      RewriteCond %{REQUEST_FILENAME} !-f
      RewriteCond %{REQUEST_FILENAME} !-d
      RewriteRule ^.* /gitweb.cgi/$0 [L,PT]
</Directory>

(2)重新启动apache：sudo /etc/init.d/apache2 restart，访问http://localhost/cgi-bin/gitweb.cgi

 

 

(二)   Git 管理员(git bash下运行)

1.安装msysgit,

    下载地址：http://code.google.com/p/msysgit/downloads/list

     缺省安装。

 

2.生成服务器管理员公钥。

    执行命令ssh-keygen -t rsa，操作时刻参照第一部分第7步，用于提供给服务器端初始化gitosis。

 

3.从服务器 克隆gitosis-admin.git

    首先选定目录，如G盘：cd /g/

    然后，新建一个目录mkdir gitproject

    git clone git@YOUR_SERVER:gitosis-admin.git

    ( YOUR_SERVER可以是你的服务器名称或者ip,我这里的ubuntu的ip为192.168.1.102 )

4. 编辑 gitosis.conf

     cd gitosis-admin

     你将看到以下文件gitosis.conf和keydir/，gitosis.conf是gitosis的配置文件，用于配置用户和权限，keydir/是所有组成员的

公钥。

     vi gitosis.conf， 打开gitosis.conf文件，内容为：

     [group gitosis-admin]
     writable = gitosis-admin
     members =  Administrator@LILIN

     这个是管理组的权限，members中的用户名就是刚才上传的公钥里面的用户名。

     

     把内容修改为:

     [gitosis]
     gitweb = yes

     [group gitosis-admin]
     writable = gitosis-admin
     members = Administrator@LILIN wirror800@192.168.1.102

     [group apps ]
     writable = apps
     members = Administrator@LILIN wirror800@192.168.1.102

     其中 gitweb = yes表示启用对gitweb的支持。 这里定义了一个叫apps 的组，授予Administrator@LILIN和wirror800@192.168.1.102

两个用户写“apps ”这个repo的权限

    

     然后push到服务端后，服务器端就立刻生效。

     git commit -a -m “created a new repository”

     git push

     这样就 更新了服务端的权限。

 

5.创建一个app的repo

     mkdir apps

     cd apps

     git init

6.创建、编辑 .gitignore , 用于忽略某些不需要进行代码管理的内容，如rails的应用可能如下：

    .DS_Store
      log/*.log
      tmp/**/*
      config/database.yml
      db/*.sqlite3

   

7.编辑 .git/description 内容， 加上apps 的说明

8. 提交代码

    git remote add origin git@YOUR_SERVER:apps.git

     git add .

     git commit -am "imitial import"

    git push origin master:refs/heads/master

9.增加成员的公钥到系统中

    cd ../gitosis-admin

    cp member_1.pub keydir/

    cp member_2.pub keydir/ git

    add keydir/member_1.pub keydir/member_2.pub

 

    修改gitosis.conf,并提交

    [group apps]
    - members = wirror800
    + members = wirror800 member_1 member_2
    writable = apps

 

    git commit -a -m "Granted new members commit rights to apps"
    git push

 

10. 其它成员获取apps的代码

    git clone git@YOUR_SERVER:apps.git

 

  在windows下安装git服务器也是可以的，我们开始尝试使用Cygwin来操作，但在使用gitweb的时候遇到困难。git毕竟诞生于

linux,还是建议大家使用linux来搭建git服务器吧。Mr. Zhang也提供了一个可以在windows下安装git服务器的方法，链接地址奉献

给大家：http://www.timdavis.com.au/git/setting-up-a-msysgit-server-with-copssh-on-windows/ 。再次感谢CTO Mr. Zhang 这几天

执着的奉献精神，让我受益匪浅。