git服务器搭建过程

参考网上资料搭建git过程记录 如下：

需求

硬件需求：一台Ubuntu，能通过网络访问到。
软件需求：git-core, gitosis, openssh-server, openssh-client

1> 安装git和openssh:

 

新加用户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

2> 安装配置gitosis

初始化一下服务器的git用户，这一步其实是为了安装gitosis做准备。在任何一台机器上使用git，第一次必须要初始化一下(引号里的myname要改成这个用户的名字，我用的是jerry_yu)：
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:/tmp$ git clone

 

回到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# sudo chmod 755 /home/repo/gitosis-admin.git/hooks/post-update

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

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

在服务器上新建一个空的项目仓库，叫“teamwork”。

切换到git用户：

a@server:/home/git$ su – git

$ cd /home/repo

$ mkdir teamwork.git

$ cd teamwork.git

$ git init –bare

$ exit

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

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

4> 管理gitosis的配置文件

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

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

• 如果出现：
  fatal: '~/gitosis-admin.git' does not appear to be a git repository
  fatal: The remote end hung up unexpectedly
  改成:
  
  (即改成了绝对路径，感觉这样会出问题）

该目录下的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

(刚才不是已经把id_rsa.pub得到到server上的/tmp目录么？所以这里只需把id_rsa.pub复制到./keydir/目录下即可)
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

5> 初始化测试项目

好了，现在服务器就搭建完了，并且有一个空的项目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@:teamwork.git
usr@pc1:~/work/teamwork-ori$ git push origin master

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

以下是我的截图，这里用了绝对路径，所以权限可能没有了，即下面输入的密码是git用户的密码，而不是我生成id_rsa.pub的密码了。

• 
  Cloning into 'mt6575'...
  
  Cloning into 'mt6575'...
  
  Cloning into 'mt6575'...
  git@192.168.0.118:/home/repo/mt6575.git
  Cloning into 'mt6575'...
  
  Cloning into 'mt6575'...
  
  Cloning into 'mt6575'...
  password:
  remote: Counting objects: 244670, done.
  remote: Compressing objects: 100% (168908/168908), done.
  Receiving objects:  10% (24467/244670), 45.81 MiB | 30.36 MiB/s
  

6> 添加已有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了，呵呵.

<以下没有配置过>

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

ServerName 172.20.146.39
DocumentRoot /home/repo
ScriptAlias /cgi-bin/ /home/repo

Options ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch
AllowOverride All
order allow,deny
Allow from all
AddHandler cgi-script cgi
DirectoryIndex gitweb.cgi

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
git clone
git访问方式：
git clone git@192.168.1.1:alsa-lib.git
Web网页浏览：

遇到的问题：
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）root@android-2.1_r2$ rm -Rf .repo

 

---

//以上是转裁自罗索实验室，下面的内容是自己总结的，望广大博友斧正其中的错误。

1》》如何用git和一个已经存在的项目建立联系？

这个过程其实就是上在第五步提到的初始化一个测试项目，即先建一个空的项目，然后通过git把已有项目的代码上传到这个空项目中：

git init --bare

git add .

git commit -am “initial version”

git remote add origin git@192.168.100.10:/home/repo/mt6575.git    

git push origin master

关于如何添加一个新的项目，下面这篇文章说得不错：http://blog.longwin.com.tw/2011/03/linux-gitosis-git-server-2011/

建立專案

1. cd ~/
2. mkdir project_name
3. cd project_name
4. git init
5. git remote add origin [e-mail]:project_name.git # gitosis 會自行於 /srv/gitosis/repositories 新增
6. touch readme
7. git add .
8. git commit -m 'initial'
9. git push origin master:refs/heads/master # 或 git push origin master

2》》权限是如何管理的？

虽然文中说明了是用gitosis配合ssh来管理的，但作为普通用户，在clone服务器上的代码的时候，还是不明白这两者的区别有多大： git clone  和  git clone
在实验中发现前者（使用绝对路径）时，输入密码是git用户的密码，而后者输入任何密码都无法clone。

 关于这个问题，下面这篇文章解释得很详细：

安装部署具体可以参考http://scie.nti.st/2007/11/14/hosting-git-repositories-the-easy-and-secure-way，或者参考《pro git》相关章节。这里只列出对问题的总结。

1.gitosis-init时直接使用git账户操作即可

[git@localhost ~]$ gitosis-init < /tmp/id_rsa.pub

2.
init成功后，默认生成：

Initialized empty Git repository in /home/git/repositories/gitosis-admin.git/

并且以/home/git/repositories作为git项目的根目录，也就是新建的或者已有的git项目需要放到这里。
那么访问路径就可以直接写项目的相对路径了，比如：

git clone git@localhost:gitosis-admin.git

注意到这里并不是repositories/gitosis-admin.git或者其他的。

3.gitosis只会在ssh的公钥授权方式起作用
如果使用ssh的密码授权clone项目，gitosis是不起作用的。也就是大家对所有项目都是读写的权限，并且项目路径是绝对路径，这时候clone的路径为：

git clone git@localhost:/home/git/repositories/gitosis-admin.git

这和未安装gitosis是一致的。未安装gitosis之前，不管是公钥授权还是密码授权，均使用绝对路径。

4.'gitosis-admin.git' does not appear to be a git repository错误
ssh一般会配置为公钥和密码授权两者同时开启，当公钥验证不通过时，还会继续使用密码验证，这时候会提示输入密码。所以经常会出现以下的错误：

Cloning into gitosis-admin...
git@localhost's password:
fatal: 'gitosis-admin.git' does not appear to be a git repository
fatal: The remote end hung up unexpectedly

[root@localhost ~]# git clone git@localhost:gitosis-admin.git
Cloning into gitosis-admin...
git@localhost's password:
fatal: 'gitosis-admin.git' does not appear to be a git repository
fatal: The remote end hung up unexpectedly

原因：
客户端和服务端的公钥授权没配置正确，解决即可。
另：
因为触发了密码授权，提示错误确实是因为路径找不到，参考第3点，这时候如果写绝对路径，也可以获取到项目，但是绕过了gitosis的权限控制。