git服務器搭建過程

from :http://blog.csdn.net/ice520301/article/details/6142503

Author: 

ice520301

http://blog.csdn.net/ice520301/article/details/6142503

參考網上資料搭建git服務器過程記錄 如下：

需求

硬件需求：一臺Ubuntu或者debian電腦（虛擬機），能通過網絡訪問到。

軟件需求：git-core, gitosis, openssh-server, openssh-client, Apache2(Gitweb)

安裝配置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

初始化一下服務器的git用戶，這一步其實是爲了安裝gitosis做準備。在任何一 臺機器上使用git，第一次必須要初始化一下：
a@server:~$ git config –global user.name “myname”
a@server:~$ git config –global user.email “myname@server “

安裝一下python的setup tool， 這個也是爲了gitosis做準備：
a@server:~$ sudo apt-get install python-setuptools

獲得gitosis包：
a@server:~$ cd /tmp
a@server:/tmp$ git clone git://eagain.net/gitosis.git
a@server:/tmp$ cd gitosis
a@server:/tmp/gitosis$ sudo python setup.py install

切換到git用戶下：
a@server:/tmp/gitosis$ su git

默認狀態下，gitosis會將git倉庫放在 git用戶的home下，所以我們做一個鏈接到/home/repo
$ ln -s /home/repo /home/git/repositories

再次返回到默認用戶
$ exit

如果你將作爲git服務器的管理員，那麼在你的電 腦上(另一臺pc）生成ssh公鑰：
usr@pc1:~$ ssh-keygen -t rsa
將公鑰拷貝到服務器的/tmp下：
usr@pc1:~$ scp .ssh/id_rsa.pub git@<server>:/tmp

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

讓gitosis運行起來：
a@server:/tmp/gitosis$ sudo -H -u git gitosis-init < /tmp/id_rsa.pub
Initialized empty Git repository in /home/repo/gitosis-admin.git/
Reinitialized existing Git repository in /home/repo/gitosis-admin.git/

gitosis的有趣之處在於，它通過一個git倉庫來管理配置文件，倉庫就放在了/home/repo/gitosis- admin.git。我們需要爲一個文件加上可執行權限：
a@server:/home/git$ sudo passwd root
a@server:/home/git$ su
root@server:/home/git # cd repositories
root@server:/home/git/repositories # cd gitosis-admin.git/
root@server:/home/git/repositories/gitosis-admin.gi t # 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
$ cd teamwork.git
$ git init --bare
$ exit

但是，到目前爲止，這只是一個空倉庫，空倉庫是不能clone下來的。爲了能做clone，我們必須先讓某個有權限的人放一個初始化的版本到倉庫中。

所以，我們必須先修改一下gitosis-admin.

管理gitosis的配置文件

剛剛提到，gitosis本身的配置也是通過git來實現的。在你自己的開發機裏，把gitosis-admin.git這個倉庫clone下來，就可以以管理員的身份修改配置了。

在你的電腦裏：
usr@pc1:~/work$ git clone git@<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 clone git@<Server-IP>:/home/prj_git/gitosis-admin.git

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]

[group gitosis-admin]
writable = gitosis-admin
members = a@server usr@pc1

[group hello]
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 and users”
usr@pc1:~/work/gitosis-admin$ git push origin master

初始化測試項目

好了，現在服務器就搭建完了，並且有一個空的項目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 clone git@<server>:teamwork.git

$ cd teamwork
$ vim hello
$ 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庫：
git clone git://android.git.kernel.org/platform/external/alsa-lib.git
git clone git://android.git.kernel.org/platform/external/alsa-utils.git

生成bare庫
git clone –bare alsa-lib alsa-lib.git
git clone –bare alsa-utils alsa-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 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

 

<以下未經測試>

配 置web訪問方式：

Apache常用命令：
a2dissite gitserver 禁用
a2ensite gitserver  使能
/etc/init.d/apache2 restart 重啓

1.apt-get install apache2

2.手動安 裝gitweb
git clone git://git.kernel.org/pub/scm/git/git.git
cd git
make GITWEB_PROJECTROOT=”/home/repo” prefix=/usr gitweb/gitweb.cgi
cd gitweb
cp -av git* /home/repo/

3.vim /etc/apache2/sites-available/gitserver
<VirtualHost 172.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
Allow from all
AddHandler cgi-script cgi
DirectoryIndex gitweb.cgi
</Directory>
</VirtualHost>

4.賦予權限，很重要：

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

mv hooks/post-update.sample hooks/post-update

5.a2ensite gitserver
6./etc/init.d/apache2 restart

匿名訪問方式：
git clone http://192.168.1.1/alsa-lib.git 
git clone http://192.168.1.1/alsa-utils.git 
git訪問方式：
git clone [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”): No such file or directory
error: unable to index file external/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”): No such file or directory
error: unable to index file apps/md4.c
fatal: adding files failed
（3） [email protected]_r2$ rm -Rf .repo
[email protected]_r2 $ find . -name “.git” | xargs rm -Rf