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 perl

1.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.git

2. 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>

关键参数说明：

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 main

3. 子项目管理与权限配置

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 main

3.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:~/bin

4.2 初始化 Repo 客户端

mkdir myproject && cd myproject repo init -u git@yourserver.com:manifest.git -m default.xml repo sync

4.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 --continue

5. 高级配置与优化

5.1 性能优化建议

SSH 连接优化：

# ~/.ssh/config Host gitserver HostName yourserver.com User git Compression yes ControlMaster auto ControlPath ~/.ssh/control-%r@%h:%p ControlPersist 1h

Repo 同步优化：

repo sync -j8 --optimized-fetch --no-tags

5.2 安全加固措施

Gitolite 权限审计：

# 查看有效权限 ssh git@yourserver.com info

SSH 密钥轮换：

# 管理员操作 cd gitolite-admin/keydir mv old_key.pub archive/ git add . git commit -m "Rotate user keys" git push origin main

5.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 文件的高级用法，再到客户端的高效工作流，这套解决方案能够满足中小型团队对多项目代码管理的需求。实际部署时，建议根据团队规模和工作习惯适当调整权限结构和同步策略。