ubuntu 12.04 git gitosisi gitolite 服务器搭建相关汇总。

首先需要安装Git和Gitolite

$ sudo apt-get install git-core
$ sudo apt-get install gitolite

安装完成后，接下来给gitolite创建一个用户

sudo adduser \
    --system \
    --shell /bin/bash \
    --gecos 'git version control' \
    --group \
    --disabled-password \
    --home /home/git \
    git

用户添加完成后需要切饿换到添加好的git用户上去，设置path变量，然后cd到git用户根目录下

sudo su - git
echo "PATH=$HOME/bin:$PATH" > ~/.bashrc
cd

切换到普通用户（例如put）生成密钥并拷贝到git根目录下
sudo su put
$ ssh-keygen -t rsa

$ scp ~/.ssh/id_rsa.pub /home/git/git.pub

 

但是需要注意权限问题。如果存在权限问题，可以通过chown命令来修改权限以便可以让git用户安全访问，需要在有权限的用户下进行。

$ sudo chown git.git id_rsa.pub

然后在git用户的权限下运行以下脚本

$ gl-setup git.pub

这个脚本会将会安装并初始化你的gitolite结构，安装过程中会弹出一个编辑器，需要做一些小修改

# 将 $REPO_UMASK = 0077; 修改成 $REPO_UMASK = 0027;

执行完后将会生成以下的结构

creating gitolite-admin...
Initialized empty Git repository in /home/git/repositories/gitolite-admin.git/
creating testing...
Initialized empty Git repository in /home/git/repositories/testing.git/
[master (root-commit) 94864dc] start
 2 files changed, 6 insertions(+)
 create mode 100644 conf/gitolite.conf
 create mode 100644 keydir/jerry.pub

回到本机，就可以将该gitolite的管理项目clone下来了

$ git clone git@<server>:gitolite-admin.git

说回来，因为之前已经存在一个gitosis的admin项目，在这里需要做的其实很简单，将gitosis-admin中keydir目录内的所有成员的key拷贝到'gitolite-admin/keydir'目录下即可。conf配置文件中可以加入之前旧项目的配置，这里是配置文件的语法格式，还有如何添加和移除用户

$ git clone gitolite:gitolite-admin.git
Initialized empty Git repository in /data/tmp/gitolite-admin/.git/
remote: Counting objects: 6, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 6 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (6/6), done.

$ cd gitolite-admin/

$ ls -F
conf/  keydir/

$ ls conf
gitolite.conf

$ ls keydir/
admin.pub

我们可以看出 gitolite-admin 目录下有两个目录 conf/ 和 keydir/ 。

• keydir/admin.pub 文件

  目录 keydir 下初始时只有一个用户公钥，即 amdin 用户的公钥。

• conf/gitolite.conf 文件

  该文件为授权文件。初始内容为:

  #gitolite conf
  # please see conf/example.conf for details on syntax and features
  
  repo gitolite-admin
      RW+                 = admin
  
  repo testing
      RW+                 = @all
  

  缺省授权文件中只设置了两个版本库的授权：

  • gitolite-admin

    即本版本库（gitolite管理版本库）只有 admin 用户有读写和强制更新的权限。

  • testing

    缺省设置的测试版本库，设置为任何人都可以读写以及强制更新。

如果想要增加用户，之需要把相应用户的公钥拷贝到key/文件夹下面并且更改conf/gitolite.conf即可。

• 例如我们在其中加入用户组 @team1，将新添加的用户 jiangxin, dev1, dev2 都归属到这个组中。

  我们只需要在 conf/gitolite.conf 文件的文件头加入如下指令。用户之间用空格分隔。

  @team1 = dev1 dev2 jiangxin
  

想增加版本库repo，并设置为team1组可以访问，之需要在这个配置文件下面添加

repo repo
        RW+                 = @team1

git add .   /  git commit -am "zhushi" /git push 即可。系统将自动创建版本库并赋予相应权限。

示例代码：

[evans@client]$ vim conf/gitolite.conf
# Add following content to the gitolite.conf
# repo    codingme
#         RW+     =   @all
[evans@client]$ git commit -a -m "Add codingme repository"
[master f044f8c] Add codingme repository
1 files changed, 3 insertions(+), 0 deletions(-)
[evans@client]$ git push
Counting objects: 7, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (4/4), 380 bytes, done.
Total 4 (delta 1), reused 0 (delta 0)
remote: creating codingme...
remote: Initialized empty Git repository in /root/repositories/codingme.git/
To root@192.168.108.22:gitolite-admin
0b1be51..f044f8c  master -> master

gitosis与gitolite相关资料：

先说说我首先体验的gitosis，用Python写成，主页，也是ProGit详叙的一种方案，目前基本上已经停止更新。我觉得最大的特色就是其怪异的配置文件和项目映射，国内有人对其做了改进，包括增加了管理员角色，只有管理员才能够创建版本库，版本库匹配支持通配符，这样在授权的时候，可以用通配符为某个目录下的所有代码库授权，增加了版本库路径映射的可用性。版本库路径映射在代码库重构中非常有用，创建版本库只有写操作才进行，读操作不创建版本库，版本库名称中允许出现中文（UTF-8）等等。

Fork后项目放到了GitHub，地址是https://github.com/ossxp-com/gitosis

相当来说增加了很多改进，推荐大家参照ProGit描述的方式试试，部署过程都是一样的。

但是我觉得我有点洁癖，gitosis的配置文件太怪异了，不是完全像SVN那样进行基于版本库的ACL，而是基于用户组合用户的授权，这样无限写下去我觉得会出现不可预知的问题。比如出现版本库的交叉授权，比如每次新建库都要重新修改对用户的定义等等。

于是考虑试试基于perl的gitolite。版本库权限配置规则完全是SVN风格的。比如

#gitolite conf
# please see doc/gitolite.conf.mkd for details on syntax and features
repo gitolite-admin
RW+ = ihipop
repo testing
RW+ = @all

配置方法也很简单，参考这篇文章就可以了，推荐使用gl-easy-install进行远程安装。
安装的时候会在Git服务器上再生成一个密钥对，位于.ssh目录下，同时还会修改~/.ssh/config，用远程安装的时候指定的主机名命名。拷贝下来到本机使用即可。
tortoiseGit如果使用plink方式的话需要使用Putty的私钥key。记得转换下。这个key没有命令行的存取权限，只能使用Git命令。如果需要进行命令行操作，需要用之前的那个key。同时安装程序会自己修改~/.ssh/config 加入主机别名的设定等等
操作完毕后需要检出管理员库，这个库只有一开始创建的那个密钥才能检出(默认)。
授权文件语法的详解 http://www.ossxp.com/doc/git/gitolite.html#id13
这里摘录里面的例子

下面我们看一个不那么简单的授权文件:
1 @admin = jiangxin wangsheng
2
3 repo gitolite-admin
4 RW+ = jiangxin
5
6 repo ossxp/.+
7 C = @admin
8 RW = @all
9
10 repo testing
11 RW+ = @admin
12 RW master = junio
13 RW+ pu = junio
14 RW cogito$ = pasky
15 RW bw/ = linus
16 - = somebody
17 RW tmp/ = @all
18 RW refs/tags/v[0-9] = junio
在上面的示例中，我们演示了很多授权指令。
第1行，定义了用户组 @admin，包含两个用户 jiangxin 和 wangsheng。
第3-4行，定义了版本库 gitolite-admin。并指定只有用户 jiangxin 才能够访问，并拥有读(R)写(W)和强制更新(+)的权限。
第6行，通过正则表达式定义了一组版本库，即在 ossxp/ 目录下的所有版本库。
第7行，用户组 @admin 中的用户，可以在 ossxp/ 目录下创建版本库。
创建版本库的用户，具有对版本库操作的所有权限。
第8行，所有用户都可以读写 ossxp 目录下的版本库，但不能强制更新。
第9行开始，定义的 testing 版本库授权使用了引用授权语法。
第11行，用户组 @admin 对所有的分支和里程碑拥有读写、重置、添加和删除的授权。
第12行，用户 junio 可以读写 master 分支。（还包括名字以 master 开头的其他分支，如果有的话）。
第13行，用户 junio 可以读写、强制更新、创建以及删除 pu 开头的分支。
第14行，用户 pasky 可以读写 cogito 分支。 (仅此分支，精确匹配）。