Repo 服务端搭建实战：基于 Gitolite 与 Manifest 管理 2 个 Git 子项目
Repo 服务端搭建实战：基于 Gitolite 与 Manifest 管理 2 个 Git 子项目
在当今软件开发领域，多模块项目已成为常态。如何高效管理这些分散的代码库，确保团队协作顺畅，是每个技术负责人必须面对的挑战。本文将带您从零开始搭建一个完整的 Repo 服务端环境，通过 Gitolite 实现精细化的权限控制，利用 Manifest 文件统一管理多个 Git 子项目，最终构建一个适合企业内网或局域网使用的高效代码管理平台。
1. 环境准备与 Gitolite 安装
搭建 Repo 服务端的第一步是准备基础环境并安装 Gitolite。Gitolite 是一个轻量级的 Git 服务器管理工具，它通过 SSH 协议提供细粒度的访问控制，非常适合作为 Repo 服务端的基础。
1.1 系统要求与依赖安装
确保您的 Linux 服务器满足以下基本要求：
- Ubuntu 20.04 LTS 或 CentOS 8 及以上版本
- 至少 2GB 内存和 20GB 磁盘空间
- 已安装 Python 3.6+ 和 Git 2.20+
安装必要依赖包：
# Ubuntu/Debian sudo apt update && sudo apt install -y git python3 openssh-server perl # CentOS/RHEL sudo yum install -y git python3 openssh-server perl1.2 Gitolite 初始化配置
我们将使用专用用户git来运行 Gitolite 服务：
sudo adduser --system --shell /bin/bash --group git sudo su - git接下来，克隆 Gitolite 仓库并进行初始化：
git clone https://github.com/sitaramc/gitolite.git mkdir -p ~/bin gitolite/install -to ~/bin # 初始化 Gitolite 管理仓库 ~/bin/gitolite setup -pk admin.pub注意：在执行上述命令前，请确保已将您的 SSH 公钥（通常为
~/.ssh/id_rsa.pub）复制到 git 用户的家目录并重命名为admin.pub
1.3 服务端仓库结构规划
合理的仓库结构对于后续管理至关重要。我们建议采用以下目录布局：
/home/git/repositories/ ├── gitolite-admin.git # Gitolite 管理仓库（自动创建） ├── manifest.git # Repo manifest 仓库（手动创建） ├── project_1.git # 子项目1 └── project_2.git # 子项目2创建 manifest 仓库：
git init --bare manifest.git2. Manifest 仓库配置详解
Manifest 是 Repo 工具的核心配置文件，它定义了所有子项目的结构关系和同步策略。我们将创建一个功能完备的 default.xml 文件，支持两个子项目的管理。
2.1 default.xml 基础结构
创建一个新的 default.xml 文件，包含以下基本元素：
<?xml version="1.0" encoding="UTF-8"?> <manifest> <remote name="origin" fetch="git@yourserver.com:" /> <default remote="origin" revision="main" sync-j="4"/> <project name="project_1.git" path="project_1" /> <project name="project_2.git" path="project_2" /> </manifest>关键参数说明：
| 参数 | 描述 | 示例值 |
|---|---|---|
| remote name | 远程仓库别名 | origin |
| fetch | 仓库基础路径 | git@server: |
| default revision | 默认分支 | main |
| sync-j | 并行同步任务数 | 4 |
| project name | Git 仓库名称 | project_1.git |
| project path | 本地检出路径 | project_1 |
2.2 高级 Manifest 功能实现
为满足企业级需求，我们可以扩展 manifest 功能：
分支管理：为不同项目指定不同分支
<project name="project_1.git" path="project_1" revision="dev" /> <project name="project_2.git" path="project_2" revision="release/v1.0" />组管理：通过 groups.xml 组织相关项目
<!-- groups.xml --> <groups> <group name="core"> <project name="project_1.git" /> </group> <group name="plugins"> <project name="project_2.git" /> </group> </groups>复制文件：在同步时自动复制特定文件
<project name="project_1.git" path="project_1"> <copyfile src="config/env.example" dest=".env"/> </project>2.3 Manifest 版本控制策略
将 manifest 文件提交到 Git 仓库以实现版本控制：
git clone git@localhost:manifest.git cd manifest cp /path/to/default.xml . git add default.xml git commit -m "Add initial manifest file" git push origin main3. 子项目管理与权限配置
3.1 创建并初始化子项目
通过 Gitolite 管理界面创建两个子项目：
# 编辑 gitolite-admin/conf/gitolite.conf repo project_1.git RW+ = admin RW = dev_team R = qa_team repo project_2.git RW+ = admin RW = plugin_team提交并推送权限变更：
cd gitolite-admin git add conf/gitolite.conf git commit -m "Add project_1 and project_2 repositories" git push origin main3.2 自动化初始化脚本
创建可复用的初始化脚本init_repos.sh：
#!/bin/bash # 初始化 manifest 仓库 git init --bare manifest.git # 初始化子项目仓库 for repo in project_1 project_2; do git init --bare ${repo}.git echo "Initialized ${repo}.git" done # 设置目录权限 chown -R git:git /home/git/repositories chmod -R 750 /home/git/repositories echo "All repositories initialized successfully"4. 客户端配置与工作流
4.1 客户端环境准备
在开发机器上安装 Repo 工具：
mkdir -p ~/bin curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo chmod a+x ~/bin/repo export PATH=$PATH:~/bin4.2 初始化 Repo 客户端
mkdir myproject && cd myproject repo init -u git@yourserver.com:manifest.git -m default.xml repo sync4.3 日常开发工作流
同步最新代码：
repo sync创建特性分支：
repo start feature/new-ui --all提交更改：
# 在单个项目中 git add . git commit -m "Implement new UI components" # 跨项目提交 repo upload解决冲突：
repo sync # 手动解决冲突后 git add -u git rebase --continue5. 高级配置与优化
5.1 性能优化建议
SSH 连接优化：
# ~/.ssh/config Host gitserver HostName yourserver.com User git Compression yes ControlMaster auto ControlPath ~/.ssh/control-%r@%h:%p ControlPersist 1hRepo 同步优化：
repo sync -j8 --optimized-fetch --no-tags5.2 安全加固措施
Gitolite 权限审计：
# 查看有效权限 ssh git@yourserver.com infoSSH 密钥轮换：
# 管理员操作 cd gitolite-admin/keydir mv old_key.pub archive/ git add . git commit -m "Rotate user keys" git push origin main5.3 监控与维护
仓库大小监控：
#!/bin/bash for repo in /home/git/repositories/*.git; do size=$(du -sh $repo | cut -f1) echo "$(basename $repo): $size" done定期清理：
# 在 Git 仓库中执行 git gc --aggressive --prune=now通过本文的详细指导，您已经掌握了从零搭建 Repo 服务端的完整流程。从 Gitolite 的基础配置到 Manifest 文件的高级用法，再到客户端的高效工作流，这套解决方案能够满足中小型团队对多项目代码管理的需求。实际部署时，建议根据团队规模和工作习惯适当调整权限结构和同步策略。