使用Gitolite搭建Git服务器

         Gitolite是一款Perl语言开发的Git服务管理工具，通过公钥对用户进行认证，并能够通过配置文件对些操作进行基于分支和路径的精细控制。Gitolite采用的是SSH协议并且使用SSH公钥认证，因此无论是管理员还是普通用户，都需要对SSH有所了解。Gitolite的官网是：https://github.com/sitaramc/gitolite。下面就来细说使用Gitolite搭建Git服务器的过程吧。

         硬件需求：Ubuntu电脑（或虚拟机），正常网络访问。

         软件需求：git-core,gitolite, openssh-server, git-daemon-run（ubuntu），msysgit（windows）

         在Gitolite的搭建过程中，Gitweb、Apache不是必须的，Gitweb、Apache跟Gitolite一起使用，看到的效果类似于 http://git.chromium.org/gitweb/。

1. 安装配置Git服务器(IP:10.203.138.129)

         安装Git和openssh。

         $ sudo apt-get install git-core openssh-server

         新建用户git，该用户作为所有代码仓库和用户权限的管理者。

         $ sudo groupadd git

         $ sudo useradd git –g git –m

         $ sudo passwd git （需要设置用户git的密码）

2. 下载gitolite

         初始化服务器的全局设置，为安装gitolite做准备。在任何一台机器上使用git，第一次必须要先设置user.name和user.email。

         $ git config --global user.name “david”

         $ git config --global user.email “david@server-pc”（name和email随意）

         安装一下python的setup tool。

         $ sudo apt-get install python-setuptools

         获取gitolite包。

         $ git clone https://github.com/sitaramc/gitolite.git（或者到网上下载对应的gitolite）

        当然，我们也可以使用包管理器进行安装。

        $ sudo aptitude install gitolite

3. 配置gitolite

         在git管理员的PC上，先安装msysgit（windows系统），安装后，打开gitbash，运行如下命令生成管理员密钥：

         $ ssh-keygen –t rsa

         运行以上命令后，可以默认提示直接回车。回车后在当前用户目录下生成了.ssh/id_rsa和.ssh/id_rsa.pub。其中.ssh/id_rsa是私玥，.ssh/id_rsa.pub是公钥。接下来可以使用如下命令将git管理员的公钥上传到git服务器，也可以直接拷贝到git服务器。

         $ scp xxx/.ssh/id_rsa.pub [email protected]:/tmp/admin.pub

         回到Git服务器上。

         $ sudo chmod a+r /tmp/id_rsa.pub

         执行Gitolite安装。

         $ gl-setup /tmp/admin.pub

         Initialized empty Git repository in /home/repo/gitolite-admin.git/

Reinitialized existing Git repository in /home/repo/gitolite-admin.git/

         Gitolite是通过一个git仓库来管理配置文件，仓库放在/home/git/repositories/gitolite-admin.git。

         设置git仓库权限

         $ sudo chown git:git /home/git/repositories

         $ sudo chmod 755 /home/git/repositories

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

4. 在服务器上新建测试项目仓库

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

         切换到git用户：

         $ su – git

         $ cd repositories

         $ git init --bare test.git

         $ exit

         到这里，test只是一个空仓库，它是不能clone下来的。为了能做clone，必须先让管理员或有权限的人放一个初始化的版本到仓库中。所以，我们必须先修改一个gitolite-admin。

5. 管理gitolite的配置文件

         Gitolite本身的配置也是通过git来实现的。在刚刚上传公钥的机器上，把gitolite-admin.git这个仓库clone下来，就可以以管理员的身份修改配置了。

         新建一个文件夹，如git129：

         $ mkdir git129

         $ cd git129

         $ git clone [email protected]:gitolite-admin.git（或使用全路径）

         注：访问git用户仓库的默认路径是/home/git/repositories/

         $ cd gitolite-admin

         该目录下的keydir目录是用来存放所有需要访问git服务器的用户的ssh公钥。各个用户按照前面提到的办法生成各自的ssh公钥文件后，把所有人的ssh公钥文件按名字重新命名一下，然后拷贝到keydir目录下，然后修改gitolite.conf文件，做相应的配置：

         [gitolite]

         [group gitolite-admin]

         writable = gitolite-admin

         members = david@DAVID-PC  tom@TOM-PC

         [group team]

         writable = test

         members = david@DAVID-PC  tom@TOM-PC  pitter@PITTER-PC

         这个配置文件表达了如下含有：gitolite-admin组成员有david，tom，该组对gitolite-admin仓库有读写权限；test组有david，tom，pitter三个成员，该组对test仓库有读写权限。目前这些配置文件的修改只是在本地，必须推送到远程的git服务器上才能真正生效。

         加入新文件、提交并push到Git服务器：

         $ git add .

         $ git commit –m “add test and someusers”

         $ git push origin master

         $ sudo chmod a+r /tmp/id_rsa.pub

6. 初始化测试项目

         现在服务器搭建完毕，并且有一个空的项目test在服务器上。接下来，需要测试一下，空仓库是不能clone的，所以需要某个有写权限的人初始化一个版本。在客户端执行：

         $ mkdir test-ori

         $ cd test-ori

         $ git init （在客户端执行，初始化一个本地的版本库）

         $ echo “/* add something */” > hello.c

         $ git add .

         $ git commit –m “initial version”

         $ git remote add origin [email protected]:test.git

         $ git push origin master

         到此为止，test已经有了一个版本了，team的其他成员只要先clone一下test仓库就可以了，而且gitolite.conf中赋予的读写权限。

7. 添加已有git项目

         如果想将一个现成的git仓库，放到Git服务器上供team使用（比如clone了一个官方的kernel仓库，想在内部使用它作为基础仓库），可以这样操作：

         首先需要从你的工作仓库中得到一个纯仓库，比如你的工作目录为~/kernel，你想将该纯仓库拷贝到Git服务器上使用。Git服务器的管理员拿到这个纯仓库（~/kernel）后，将其拷贝到/home/repo/下，同时配置gitolite相关配置文件。比如说：下载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

8. Gitweb和Git Daemon的支持

         Gitolite和Gitweb的整合提供了两个方面的内容。一个是可以设置版本库的描述信息，用于在Gitweb项目列表中显示。另一个则是自动生成项目的列表文件共Gitweb参考，避免Gitweb使用低效率的目录递归搜索查找Git版本库列表。 可以在授权文件中设定版本库的描述信息，并在gitolite-admin管理库更新时创建到版本库的description文件中。

         repo name = "one line of description"

         repo name "owner name" = "one line of description"

         第一行为名为reponame的版本库设定描述。

         第二行同时设定版本库的属主名称，以及一行版本库描述。

         对于通配符版本库，使用这种方法就不现实了。Gitolite提供了SSH子命令共版本库的创建者使用。

         $ ssh git@server setdesc path/to/repo.git

         $ ssh git@server getdesc path/to/repo.git

         第一条指令用于设置版本库的描述信息。

         第二条指令显示版本库的描述信息。

         Git服务由git-daemon的服务软件提供。虽然git-daemon可以支持写操作，但因为git-daemon没有提供认证支持，因此很少人会配置git-daemon来提供匿名的写服务。使用git-daemon提供的Git版本库只读服务效率很高。故，git-daemon一直是Git版本库只读服务的首选。

         如果想使用git协议，那么就需要安装git-daemon。

         $ sudo apt-get install git-daemon-run

         编辑git-daemon配置文件：

         $ sudo gedit /etc/sv/git-daemon/run

        

         #!/bin/bash

         exec2>&1

         echo‘git-daemon starting.’

         execchpst -ugitdaemon

                   “$(git--exec-path)”/git-daemon --verbose --export-all--enable=receive-pack --enable=upload-pack --enable=upload-archive --reuseaddr --base-path=/home/webgod/      

         说明：

         --base-path      指向Git服务器的根目录

         --enable=receive-pack

         --enable=upload-pack

         --enable=upload-archive

         以上三个是与git-clone，git-push，git-pull相关的。查看详情使用命令：$ man git-daemon查看。

        

         重启git服务器：

         $ sudo sv restart git-daemon

         在Git服务器上：

         $ cd /home/webgod

         $ mkdir RepoServer

         $ cd RepoServer

         $ git init --bare manifest.git

        

         切换到其他目录：

         $ cd ~/test

         $ git clonegit://127.0.0.1/RepoServer/manifest.git

         (è $ git clone [email protected]:/home/webgod/RepoServer/manifest.git)

         这里就实现了所谓的“匿名访问”。