[置顶] ubuntu 12.04 git服务器搭建

安装配置git服务器

安装git和openssh：

a@server:~$sudo apt-get install git-core openssh-server  openssh-client

新加用户git，该用户将作为所有代码仓库和用户权限的管理者：
a@server:~$sudo useradd -m git

a@server:~$sudo passwd  git

建立一个git仓库的存储点：
a@server:~$sudo mkdir  /home/repo

让除了git以外的用户对此目录无任何权限：
a@server:~$sudo chown git:git  /home/repo
a@server:~$sudo chmod 700  /home/repo

安装配置gitosis

安装一下python的setuptool，这个也是为了gitosis做准备：
a@server:~$sudo apt-get install python-setuptools

获得gitosis包：
a@server:~$cd /tmp
a@server:/tmp$git clone https://github.com/res0nat0r/gitosis.git
a@server:/tmp$cd gitosis
a@server:/tmp/gitosis$sudo python setup.py install

如果你将作为git服务器的管理员，那么在你的电脑上(另一台pc）生成ssh公钥,在~/.ssh目录下生成公私钥：
usr@pc1:~$ssh-keygen-t rsa
将公钥拷贝到服务器的/tmp下：
usr@pc1:~$scp .ssh/id_rsa.pubgit@<server>:/tmp

回到git服务器上
a@server:/tmp/gitosis$sudo chmod a+r /tmp/id_rsa.pub

让gitosis运行起来：
a@server:/tmp/gitosis$suclone时不能用绝对路径，sudo-H -u git gitosis-init < /tmp/id_rsa.pub

执行后显示以下内容表示成功了(在git 下生成了repository)：
Initializedempty Git repository in /home/repo/gitosis-admin.git/
Reinitializedexisting Git repository in /home/repo/gitosis-admin.git/

gitosis的有趣之处在于，它通过一个git仓库来管理配置文件，仓库就放在了/home/repo/gitosis-admin.git。我们需要为一个文件加上可执行权限：
a@server:/home/git$sudo passwdroot从本地主机通过SSH登录远程主机server时不再输入口令。这里假定使用OpenSSH2.9和SSHProtocol 2。对OpenSSH3.6在sshd的配置文件（/etc/ssh/sshd_config）中可以指定authorizedkey文件的位置：
a@server:/home/git$su
root@server:/home/git# cd repositories
root@server:/home/git/repositories# cdgitosis-admin.git/
root@server:/home/git/repositories/gitosis-admin.git#sudo chmod 755/home/repo/gitosis-admin.git/hooks/post-update

root@server:/home/git/repositories/gitosis-admin.git # exit

 

在服务器上新建一个测试项目仓库

我建了一个叫“teamwork”的仓库。
切换到git用户：
a@ubuntu:/home/git$su - git
$ cd /home/prj_git
$ mkdir teamwork.git
$ cdteamwork.git
$ git init --bare
$ exit

但是，到目前为止，这只是一个空仓库，空仓库是不能clone下来的。为了能做clone，我们必须先让某个有权限的人放一个初始化的版本到仓库中。

所以，我们必须先修改一下gitosis-admin.

管理gitosis的配置文件

刚刚提到，gitosis本身的配置也是通过git来实现的。在你自己的开发机里，把gitosis-admin.git这个仓库clone下来，就可以以管理员的身份修改配置了。

在你的电脑里：
usr@pc1:~/work$git clonegit@<server>:gitosis-admin.git

如果出现：

fatal:'~/gitosis-admin.git' does not appear to be a git repository
fatal:The remote end hung up unexpectedly

改成全路径:

usr@pc1:~/work$sudo git clonegit@<Server-IP>:/home/prj_git/gitosis-admin.git

添加用户的时候， 用户执行ssh-keygen-t rsa , 一直回车，最后生成id_rsa.pubid_rsa,将id_rsa拷贝给管理员，管理员将用户id_rsa.pub改成对应用户的名字，如 改成huangbozhi.pub,再将该huangbozhi.pub放到keydir下，修改gitosis.conf文件，新增该用户huangbozhi,管理员提交后，该用户就可以clone代码了。

usr@pc1:~/work$cd gitosis-admin/

该目录下的keydir目录是用来存放所有需要访问git服务器的用户的ssh公钥：

各个用户按照前面提到的办法生成各自的ssh公钥文件后，把所有人的ssh公钥文件都拿来，按名字命名一下，比如b.pub,lz.pub等，统统拷贝到keydir下：

usr@pc1:~/work/gitosis-admin$su root
root@server:/home/a/work/gitosis-admin# cp /path/to/.ssh/id_rsa.pub ./keydir/b.pub
root@server:/home/a/work/gitosis-admin# exit

修改gitosis.conf文件，我的配置大致如下：

[gitosis]

[groupgitosis-admin]
writable = gitosis-admin
members = a@serverusr@pc1

[grouphello]
writable = teamwork
members = a@server b

[group hello_ro]
readonly =teamwork
members = lz

这个配置文件表达了如下含义：gitosis-admin组成员有a,usr，该组对gitosis-admin仓库有读写权限；
team组有a，b两个成员，该组对teamwork仓库有读写权限；
team_ro组有lz一个成员，对teamwork仓库有只读权限。

当然目前这些配置文件的修改只是在你的本地，你必须推送到远程的gitserver上才能真正生效。
加入新文件、提交并push到git服务器：
usr@pc1:~/work/gitosis-admin$git add .
usr@pc1:~/work/gitosis-admin$git commit -am “add teamweok prj andusers”
usr@pc1:~/work/gitosis-admin$git push origin master//初始化一个空仓库,后续更新，提交直接gitpull/ git push即可

初始化测试项目

好了，现在服务器就搭建完了，并且有一个空的项目teamwork在服务器上。接下来呢？当然是测试一下，空仓库是不能clone的，所以需要某一个有写权限的人初始化一个版本。就我来做吧，以下是在客户端完成。

usr@pc1:~/work$mkdir teamwork-ori
usr@pc1:~/work$cd teamwork-ori/
usr@pc1:~/work/teamwork-ori$git init

usr@pc1:~/work/teamwork-ori$echo “/*add something*/” > hello

usr@pc1:~/work/teamwork-ori$git add .
usr@pc1:~/work/teamwork-ori$git commit -am “initial version”

usr@pc1:~/work/teamwork-ori$git remote add origin git@<server>:teamwork.git
usr@pc1:~/work/teamwork-ori$git push origin master

到此为止teamwork已经有了一个版本了，team的其他成员只要先clone一下teamwork仓库，就可以任意玩了。

usr@pc1:~/work/teamwork-ori$su b
$ cd /home/b
$ git clonegit@<server>:teamwork.git

$ cd teamwork
$ vimhello
$ git add .
$ git commit -am “b add”

$ git push origin master
$ exit

以下内容没验证：

添加已有git项目

另外：如果你有一个现成的git仓库，想放到gitserver上供team使用（比如你clone了一个官方的kernel仓库，想在内部使用它作为基础仓库），怎么办呢。
首先需要从你的工作仓库中得到一个纯仓库,比如你的工作目录为~/kernel,你想导出纯仓库到你的优盘里，然后拷贝到gitserver上去。
$git clone –bare ~/kernel/media/udisk
然后就拿着优盘，交给gitserver的管理员，让他拷贝到/home/repo/下，同时需要配置gitosis相关配置文件哦，这个就不用再说了吧。比如：下载ALSA库：
gitclone git://android.git.kernel.org/platform/external/alsa-lib.git
gitclone git://android.git.kernel.org/platform/external/alsa-utils.git

生成bare库
gitclone –bare alsa-lib alsa-lib.git
git clone –bare alsa-utilsalsa-utils.git

将bare库移动到git服务器目录

cp alsa-lib.git/home/repo

注意变更所有者，以获取提交权限。

chown-R git alsa-lib.git

然后就O了，呵呵.

配置gitweb

1. 安装gitweb 

   sudo apt-get install gitweb

 

2. 安装apache2

  sudo apt-get install apache2

 

3. 配置gitweb
(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站点(默认情况下可以忽略此步骤)

(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 FollowSymlinksExecCGI         
     Allow from all                        
      AllowOverrideall                     
      Orderallow,deny                      

      <Filesgitweb.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

 

<以下未经测试>

配置web访问方式：

Apache常用命令：
a2dissitegitserver 禁用
a2ensitegitserver  使能
/etc/init.d/apache2restart 重启

1.apt-get install apache2

2.手动安装gitweb
git clonegit://git.kernel.org/pub/scm/git/git.git
cd git
makeGITWEB_PROJECTROOT=”/home/repo” prefix=/usr gitweb/gitweb.cgi
cdgitweb
cp -av git* /home/repo/

3.vim/etc/apache2/sites-available/gitserver
<VirtualHost172.20.146.39:80>
ServerName 172.20.146.39
DocumentRoot/home/repo
ScriptAlias /cgi-bin/ /home/repo
<Directory/home/repo>
Options ExecCGI +FollowSymLinks+SymLinksIfOwnerMatch
AllowOverride All
order allow,deny
Allowfrom all
AddHandler cgi-script cgi
DirectoryIndexgitweb.cgi
</Directory>
</VirtualHost>

4.赋予权限，很重要：

chgrp -R www-data/home/repo
chmod a+r repo
chmod a+x repo

mvhooks/post-update.sample hooks/post-update

5.a2ensitegitserver
6./etc/init.d/apache2 restart

匿名访问方式：
gitclone http://192.168.1.1/alsa-lib.git
git clone http://192.168.1.1/alsa-utils.git
git访问方式：
gitclone [email protected]:alsa-lib.git
Web网页浏览：
http://192.168.1.1

遇到的问题：
1.windows文件命名不区分大小写，而linux支持。这样android源码下载时会出现一下问题。大约有15个文件存在这个问题。
2.库的描述文件在.git文件夹的description文件中。编辑该文件，在gitweb页中就会有description。
3.gitosis库hooks下的post-update不是由post-update.sample重命名过来的，它们不一样。post-update可以更新工作目录，保持与库一致。没有它配置文件是不会更新的。
4.(1)git@hello:/home/git$git add .
error: readlink(“external/openssl/apps/md4.c”): Nosuch file or directory
error: unable to index fileexternal/openssl/apps/md4.c
fatal: adding files failed

(2)root@/external/openssl#git init
Initialized empty Git repository in/external/openssl/.git/
root@/external/openssl# git add .
error: readlink(“apps/md4.c”): Nosuch file or directory
error: unable to index fileapps/md4.c
fatal: adding files failed
（3）[email protected]_r2$rm -Rf .repo
[email protected]_r2$find . -name “.git” | xargs rm -Rf