Gitolite安装与使用指南

项目介绍

Gitolite是一款基于Git的权限管理工具，主要用于搭建私有的Git版本库托管服务。其核心功能在于提供细粒度的访问控制，允许用户对Git仓库内的各个分支进行精确授权，极大地增强了团队协作的安全性和灵活性。

该工具由Sitaram Chamarty创建并维护，采用GPL v2许可证发布。通过结合ssh或http服务器用于用户身份验证，Gitolite在不影响Git基本功能的同时，加强了对资源访问的管控能力。

项目快速启动

环境准备

确保已具备以下条件：

• Unix类系统（Linux、Solaris等）；
• 已安装Git、Perl以及OpenSSH兼容的SSH服务；
• 无需拥有root权限，仅需一个普通用户账户；
• SSH密钥已在客户端配置完成；

安装步骤

1. 创建git用户

   sudo adduser git
   

2. 复制SSH公钥

   将客户端的公钥（默认路径 ~/.ssh/id_rsa.pub）拷贝至服务器，并重命名为 <username>.pub（例如 scott.pub）。

3. 克隆Gitolite仓库

   使用git命令拉取Gitolite源码。

   cd ~ && git clone git://github.com/sitaramc/gitolite.git
   

4. 执行安装脚本

   确保 $HOME/bin 存在并加入至 $PATH ，运行安装脚本。

   cd gitolite
   ./install -ln
   

5. 初始化gitolite-admin仓库

   初始化一个新的Git仓库作为Gitolite的核心配置存储点。

   gitolite setup -pk $HOME/scott.pub
   

   这一步将创建 ~/repositories/gitolite-admin.git 仓库，之后可将其推送至其他开发者的工作站以开始配置。

配置与测试

在本地计算机上，使用以下命令克隆 gitolite-admin 仓库来修改权限规则：

cd ~
git clone ssh://<git-server>/<git-user>@<server-ip>:<port>/~/repositories/gitolite-admin.git

编辑 conf/gitolite.conf 文件添加或修改权限规则，然后推送更改回服务器。

cd gitolite-admin
git add .
git commit -m '更新权限'
git push origin master

以上操作成功后，新定义的规则将立即生效。

应用案例和最佳实践

示例一：单分支权限控制

假设有一个名为 foo 的仓库，初级开发者组(@junior_devs)只能向这个仓库提交变化，但不允许撤销之前的提交，而高级开发者组(@senior_devs)则不受此限。

在 conf/gitolite.conf 中添加如下规则：

repo foo
RW+nohook = @junior_devs no-delete
RW+ = @senior_devs

此外，还可以限制某个文件（例如 Makefile）仅对部分用户可见和可修改：

repo foo
RW+nohook = @junior_devs no-delete
-R/W/Makefile = @junior_devs

这能够保护关键文件免受意外破坏。

示例二：个人分支

Gitolite引入“个人分支”概念，允许每个开发者在共享仓库中建立自己的工作流，便于审查和合并代码变更。

使用以下形式的规则指定个人分支的空间：

repo <project-name>
RW+refs/personal/<devname>/* = <devname>

上述规则使 <devname> 开发者的个人分支对其本人开放读写权限。

典型生态项目

• Jenkins: 与Gitolite集成实现CI/CD自动化部署。

• SonarQube: 结合Gitolite进行代码质量分析和安全检测。

这些工具与Gitolite协同工作，构建高效、可靠的研发流程。例如，在每次代码提交时触发Jenkins构建任务，检查代码质量并执行单元测试，确保代码健康并及时反馈结果。