这篇讲团队要在内网自建 Git、替换 GitLab 时,裸 Git 服务器、GitLab 和 AngusGit 该怎么选。看完你可以按代码托管、拉取请求、评审、Issue 和分支保护这些每天在用的功能做判断,并单独核对流水线、Git LFS、导入范围和账号体系能不能直接搬过来。
只推拉代码时,裸 Git 服务器就够,它只是机器上的裸仓库(只存 Git 数据、没有可编辑的工作区)加 SSH 账号。需要拉取请求和评审、构建可以继续交给 Jenkins 时,AngusGit 社区版就可以替换内网 GitLab;要用内置流水线,则需要团队版或企业版。
1. 先列出团队每天在用什么
比较平台之前,先把团队在现有 GitLab 上的实际用法列出来。下面这张清单可以直接拿去问团队成员,请大家勾选「每周都在用」的项:
- 创建仓库、克隆、推送
- 发起合并请求,在网页上看 Diff(代码差异)、写行评、通过或打回
- 用 Issue 记录需求和缺陷,用里程碑管理版本
- 保护主分支:禁止直接推送,要求评审通过才能合并
- 按目录指定谁必须审(CODEOWNERS,一个写明各目录负责人的文件)
- 流水线:提交后自动构建、测试
- 用 Git LFS(把大文件存在仓库之外的 Git 扩展)存放大文件,例如设计稿、模型文件
- 容器镜像仓库、软件包仓库
- 对接企业目录,例如用 LDAP 统一登录
前五项是代码协作的主路径,后面几项是周边能力。选型时,主路径必须完全满足;周边能力则可以逐项看有没有替代方案。
2. 三种方案在主路径上的对比
下表把 GitLab 和 AngusGit 社区版放在同一列,和裸 Git 服务器逐项对照:
| 功能 | 裸 Git 服务器 | GitLab 与 AngusGit 社区版 |
|---|---|---|
| 仓库托管、SSH / HTTPS 推拉 | 有(SSH) | 两者都有 |
| 网页浏览代码和提交历史 | 没有 | 两者都有 |
| 合并请求 / 拉取请求 | 没有 | 两者都有,AngusGit 界面叫 拉取请求 |
| 网页上的代码评审(Diff、行评、通过 / 打回) | 没有 | 两者都有 |
| 分支保护(禁止直推、必须评审) | 没有 | 两者都有 |
| CODEOWNERS 自动指派评审人 | 没有 | 两者都有 |
| Issue、标签、里程碑、Release、Wiki | 没有 | 两者都有 |
| 访问令牌、部署密钥 | 没有 | 两者都有 |
| 操作记录(谁改了成员、保护规则、合并了什么) | 没有 | 两者都有(AngusGit 在 动态 里查) |
从表里能看出,分界线在于有没有网页。裸 Git 服务器能保存代码、能推拉,但没有网页,所以也没有拉取请求和评审,所有规则都只能靠口头约定。只要团队要求「改动先经过评审再合进主分支」,就至少需要 GitLab 或 AngusGit 这一类平台。
在主路径上,AngusGit 社区版和 GitLab 能做的事一一对应;两者的差别主要在周边能力和迁移细节上,下一节逐项列出。
3. 从 GitLab 换过来,哪些不能直接平移
主路径满足之后,还要逐项检查周边能力和迁移细节。其中最需要提前确认的是流水线和 Git LFS:流水线决定替换之后团队的构建方式要不要变,LFS 决定有没有仓库根本迁不过来。下表列出每一项在 AngusGit 上的情况,以及替换时的处理办法:
| 项目 | AngusGit 的情况 | 替换时怎么处理 |
|---|---|---|
| 流水线 | 内置流水线只在团队版和企业版中提供,社区版没有 CI/CD 菜单;配置格式和 GitLab CI 不通用 | 社区版继续用 Jenkins 等现有工具构建;团队版或企业版用控制台的 导入 GitLab CI 转出初稿再改写 |
| Git LFS | 不支持 | 大文件放到制品仓库或 Release 附件;重度依赖 LFS 的仓库暂时不迁 |
| 仓库导入 | 填源地址导入时,只拿默认分支当前的代码,落成一条新提交 | 要完整历史、全部分支和标签,用 git clone --bare 加 git push --all 和 git push --tags 推过来 |
| Issue、Wiki、CI 配置、保护规则 | 导入时不会带过来 | 保护规则在 AngusGit 上重新配置;Issue 和 Wiki 按需手工整理 |
| 仓库镜像同步 | 没有 | 迁移期间只让 GitLab 一边可写,切换前再把仓库完整推送一次 |
| 容器镜像仓库、软件包仓库 | 不在 AngusGit 里 | 用制品仓库 AngusRepo 或现有的制品仓库 |
| 账号和登录 | 用户、团队和登录由配套的用户中心 GM 管理 | LDAP 对接在 GM 企业版上配置,AngusGit 本身没有单独的 LDAP 开关 |
| 用户数 | 社区版最多 10 个用户 | 超过 10 人用团队版或企业版 |
4. 部署和运维上的差别
GitLab 的一体化安装包里带了数据库、缓存、后台任务、Git 存储等多个组件,功能全,相应地需要的资源和运维精力也多。
AngusGit 只负责代码协作这一块。部署时有两个服务:AngusGit 本身,以及负责用户和登录的 GM,两者共用一个 MySQL 或 PostgreSQL 数据库;缓存是可选的,也不需要消息队列。机器最低 2 核 4 GB 就能运行,仓库多、人多时建议 4 核 8 GB。安装通过一个交互式向导完成,详细步骤见文末参考里的内网安装一文。
5. 怎么分步替换
决定替换之后,建议按下面的顺序推进。每一步都可以单独验收,验收通过再进行下一步:
- 装好并验收 在内网装好 AngusGit。验收方法是走一遍建仓、克隆、推送、发起并合并拉取请求这四步,都能完成,就说明平台可用。
-
迁一两个试点仓库
挑一两个活跃但不太关键的仓库,用
git clone --bare加git push --all、git push --tags把完整历史推过来。团队在试点仓库上正常提拉取请求、做评审,跑一两周,看日常协作是否顺畅。 -
配好保护规则
给试点仓库的
main打开分支保护(禁止直接推送、要求评审通过才能合并的规则);需要按目录指定评审人的,再加上 CODEOWNERS 文件。 - 处理构建 社区版继续用现有的构建工具。使用团队版或企业版时,把 GitLab CI 改写成内置流水线,先在试点仓库上跑通,再推广到其他仓库。
- 批量迁移,GitLab 只读保留 试点稳定后,再批量迁移其余仓库。迁移完成后,GitLab 先改为只读并保留一段时间,确认没有遗漏再归档。
迁移的完整清单见文末参考里的 GitLab 迁移清单一文,其中讲了双跑(新旧平台并行一段时间,期间只让一边可写)时怎么同步,以及出了问题怎么回滚到 GitLab。
常见问题
社区版能不能用于公司内部?
可以。社区版采用 GPL-3.0 许可证,源码公开,可以自由使用,限制是最多 10 个用户。
GitLab 上的合并请求历史能带过来吗?
带不过来。迁移只包括 Git 仓库本身,也就是提交、分支和标签;合并请求的讨论和评审记录都留在 GitLab 上。因此迁移后建议把 GitLab 只读保留一段时间,方便回查。
我们重度依赖 GitLab CI,换过来流水线要重写吗?
要改写,因为 AngusGit 的流水线配置格式和 GitLab CI 不通用。团队版和企业版的控制台可以导入 .gitlab-ci.yml、转出一份初稿,但其中的 include、artifacts、when: manual 等写法需要手动处理。改写方法见文末参考里的 GitLab CI 迁移一文。
小结
选私有化 Git,先看团队每天在用什么:只推拉代码,裸 Git 服务器就够;需要拉取请求、评审、Issue 和分支保护,AngusGit 社区版在这些主路径上和 GitLab 能做的事一一对应,可以替换内网 GitLab。替换前要确认四件事:流水线需要改写,而且只在团队版和企业版中提供;不支持 Git LFS;导入只带仓库代码;账号由 GM 管理。替换时按「安装验收、试点仓库、保护规则、构建方式、批量迁移」分步推进,GitLab 最后先只读保留、再归档。
结论: 团队的核心需求是仓库托管、拉取请求、行级评审、Issue 和分支保护时,可以用 2 核 4 GB 起步的 AngusGit 替换内网 GitLab;替换前先确认没有仓库强依赖 Git LFS,并规划好 CI 怎么构建。


Top comments (0)