Ubuntu 12.04 Gitolite 安装指南

先概述一下,你手上有一台全新的 Ubuntu Server,参照本文会安装下列内容:
  1、Git(这是肯定的)
  2、Gitolite(用于Git服务器管理,简介参见附注2)
  3、Gitdaemon(守护进程,开放一个公共的 git clone 服务,可选)
  4、Gitweb(提供像Github一样的Web服务,通过浏览器查看版本库记录,可选)

下面就开始动手吧。

1.安装openssh 

Java代码   收藏代码
  1. server> sudo apt-get install openssh  

2.在服务器上创建git用户 
Java代码   收藏代码
  1. server> adduser --system --shell /bin/bash --group git  
  2. server> adduser git ssh  
  3. server> passwd git  

一、安装 Git

安装 Git 和 Git Doc:

sudo apt-get install git-core git-doc

设置用户信息:

git config --global user.name "Your Name"
git config --global user.email [email protected]

二、安装 Gitolite

Gitolite 使用SSH进行访问控制。首先将本机的SSH公钥(生成方法参见附注3:ssh-keygen)放到服务器上:

# FROM YOUR LOCAL MACHINE
scp ~/.ssh/id_rsa.pub git.server:/tmp/your-username-goes-here.pub

创建 gitolite 用户组和 gitolite 用户

sudo addgroup gitolite
sudo adduser --disabled-password --home /home/gitolite --ingroup gitolite gitolite

安装 Gitolite:

sudo apt-get -y install gitolite

添加权限以便 gitweb 能够读取版本库内容:

sudo usermod -a -G gitolite www-data

重启apache服务:

sudo service apache2 restart

执行Gitolite安装:

sudo su - gitolite
gl-setup /tmp/your-username-goes-here.pub

安装过程中会询问你是否修改配置文件,这时候可以修改一下权限以便 git-web 和 git-daemon 能够读取新建的版本库:将 $REPO_UMASK = 0077; 修改为 $REPO_UMASK = 0027;

如果出于某种原因在安装过程中你没能修改 .gitolite.rc 文件,可以按如下方式编辑:

emacs /home/gitolite/.gitolite.rc
# 将 $REPO_UMASK = 0077; 改为 $REPO_UMASK = 0027;
chmod g+r /home/gitolite/projects.list
chmod -R g+rx /home/gitolite/repositories

退出 gitolite 账户:

exit

搞定!服务器端的工作已经完成了。

三、通过 Gitolite 管理 Git 服务器

现在你应该已经可以将安装脚本创建的 gitolite-admin 版本库克隆到你的本机了:

# FROM YOUR LOCAL MACHINE
git clone [email protected]:gitolite-admin.git

编辑 gitolite.conf 文件,创建一个名为 testing 的版本库,并且允许 git-web 和 git-daemon 的访问:

# FROM YOUR LOCAL MACHINE
cd gitolite-admin
emacs conf/gitolite.conf
# change to:
repo    testing
      RW+     =   @all
      R       =   daemon
testing "Owner" = "Test repo"

提交并推送至服务器。

git add conf/gitolite.conf
git commit -m "Enabled gitweb and git-daemon export for testing repo"
git push
cd ..

在本机Clone出testing版本库并添加个文件看看:

git clone [email protected]:testing.git
cd testing
echo "README" > README
git add README
git commit -m "Added README"
git push origin master

四、配置 Git-Daemon

git-daemon 使你可以开放一个公共的git服务,任何人都无需帐号直接使用 git clone 命令克隆版本库到本地。无需此功能的话,本步骤可以跳过。

安装 git-daemon:

sudo apt-get install git-daemon-run

修改服务配置以便 git-daemon 能够以gitolite用户组的身份运行(gitolite用户组对版本库拥有读权限)

sudo emacs /etc/sv/git-daemon/run

#!/bin/sh
exec 2>&1
echo 'git-daemon starting.'
exec chpst -ugitdaemon \
  "$(git --exec-path)"/git-daemon --verbose --base-path=/var/cache /var/cache/git

修改为:
#!/bin/sh
exec 2>&1
echo 'git-daemon starting.'
exec chpst <strong>-ugitdaemon:gitolite</strong> \
  "$(git --exec-path)"/git-daemon --verbose <strong>--base-path=/home/gitolite/repositories /home/gitolite/repositories</strong>

重启 git-daemon 服务:

sudo sv restart git-daemon

搞定。
现在你可以试试用下面的命令来克隆版本库了:

git clone git://git.server/testing.git

五、配置 Git-web

git-web 允许你使用Web界面查看版本库,此步骤也是可选的。

安装 git-web:

sudo apt-get install highlight gitweb

修改 git-web 配置:

sudo emacs /etc/gitweb.conf
# change $projectroot to /home/gitolite/repositories
# change $projects_list to /home/gitolite/projects.list

现在你可以到 http://git-server/gitweb 在线查看版本库了。

还可以做一些增强配置,比如在 /etc/gitweb.conf 中开启 pretty url:

sudo emacs /etc/gitweb.conf

添加下列内容:
# Enable PATH_INFO so the server can produce URLs of the
# form: http://git.cdwilson.us/project.git/xxx/xxx
# This allows for pretty URLs *within* the Git repository, where
# my Apache rewrite rules are not active.
$feature{'pathinfo'}{'default'} = [1];

还有更多:

$projects_list_description_width = 100;

# Enable blame, pickaxe search, snapshop, search, and grep
# support, but still allow individual projects to turn them off.
# These are features that users can use to interact with your Git trees. They
# consume some CPU whenever a user uses them, so you can turn them off if you
# need to. Note that the 'override' option means that you can override the
# setting on a per-repository basis.
$feature{'blame'}{'default'} = [1];
$feature{'blame'}{'override'} = 1;

$feature{'pickaxe'}{'default'} = [1];
$feature{'pickaxe'}{'override'} = 1;

$feature{'snapshot'}{'default'} = [1];
$feature{'snapshot'}{'override'} = 1;

$feature{'search'}{'default'} = [1];

$feature{'grep'}{'default'} = [1];
$feature{'grep'}{'override'} = 1;

$feature{'show-sizes'}{'default'} = [1];
$feature{'show-sizes'}{'override'} = 1;

$feature{'avatar'}{'default'} = ['gravatar'];
$feature{'avatar'}{'override'} = 1;

$feature{'highlight'}{'default'} = [1];
$feature{'highlight'}{'override'} = 1;

六、添加用户

用户生成公钥(参见附注3)发送给Git管理员(也就是你)
把这个公钥放到 gitolite-admin/keypair 目录下,记得名字改为 account-name.pub,
并且修改 conf/gitolite.conf 添加此用户(例如,到developer用户组里):

@developer root, account-name

最后别忘了 push 到服务器。

gitolite.conf 的书写规则参见文档:http://sitaramc.github.com/gitolite/admin.html

添加完之后此用户就可以用 git clone gitolite@host :repo-name 来克隆版本库到本地,pull 以及 push了。

附注:

  1. 参考资料:
    http://computercamp.cdwilson.us/git-gitolite-git-daemon-gitweb-setup-on-ubunt
    http://sitaramc.github.com/gitolite/master-toc.html
    http://www.tipstank.com/2011/09/01/adding-users-to-gitolite/
  2. Gitolite的管理思路是完全Git化的。服务器上有一个名为“gitolite-admin”的repo,存储Git服务配置,你只要克隆到本机,修改并push,服务器端会自动完成配置更新。大多数管理任务都无需登录服务器,可以直接在本机搞定。
  3. 如何生成SSH公钥:
    打开GitBash,执行 ssh-keygen 然后一直回车(三次)即可,最后得到结果:
    Your identification has been saved in /c/Users/xwjin/.ssh/id_rsa.
    Your public key has been saved in /c/Users/xwjin/.ssh/id_rsa.pub.
    The key fingerprint is:
    ef:76:60:21:af:58:0b:16:a5:21:83:a5:c6:d3:1e:1b xwjin@XWJIN-PC

    得到的 id_rsa.pub 就是本机的公钥了。

你可能感兴趣的:(Ubuntu 12.04 Gitolite 安装指南)