Ubuntu 上 GitLab 多项目管理与隔离实践
一 架构与隔离设计
- 使用层级化的群组 Group/子群组 Subgroup来映射组织结构（如：公司/业务线/团队），配合基于群组的权限继承，在父群组设置通用角色与保护规则，子群组与项目自动继承，减少逐库配置成本。
- 按“一个代码库只做一件事”拆分仓库，前后端、服务与工具链分离；对外部协作采用Forking 工作流，内部采用功能分支 + Merge Request协作。
- 选择分支策略：小团队可用功能分支工作流；中大型与版本化发布建议Git Flow（main/develop/feature/release/hotfix）。
- 对超大规模单体仓库（monorepo）或跨仓联动，可在 Ubuntu 客户端使用 Repo 工具配合 manifest.xml 批量拉取与同步多仓，保持工程内聚与本地开发效率。
二 命名与路由隔离
- 规范命名，避免与 GitLab 路由冲突：
- 群组/项目路径（slug）必须以字母或数字开头与结尾；可含字母、数字、下划线、点、短横；不能包含连续特殊字符；不能以点开头或结尾；不能以 .git 或 .atom 结尾。
- 项目名可含加号（+），但群组名不可。
- 禁止使用保留字作为群组或项目名（示例：groups、projects、users、admin、api、explore、search、sitemap、health_check、login、oauth、profile、public、snippets、uploads、v2、404.html、422.html、500.html、502.html、503.html 等）。
- 建议团队统一命名规范（示例）：Group 全小写、用短横分隔；Project 采用“产品线-类型-名称”格式，便于权限与 CI 模板复用。
三 权限与访问控制
- 以群组为边界进行授权：为不同团队设置Guest/Reporter/Developer/Maintainer/Owner等角色，子群组与项目继承父群组权限，必要时在子层级做细粒度调整。
- 对外协作：将项目可见性设为Private，通过Forking 工作流让外部贡献者 Fork 后提交 Merge Request；内部协作统一走 Merge Request + 代码审查。
- 保护关键分支（如：main/develop）：开启受保护分支、要求评审通过、流水线通过与线性历史，必要时限制直接推送与强制推送。
四 多项目协同与自动化
- 统一使用Issue、里程碑、看板、标签、时间跟踪进行跨项目计划与进度可视化；通过跨项目议题聚合关键任务。
- 为每个项目配置 .gitlab-ci.yml，复用CI/CD 模板实现“单仓一流水线”或“多仓统一模板”（include 机制），在流水线中做自动化测试、代码质量、构建与部署，并基于分支/标签分流到不同环境。
- 使用WebHook或流水线事件打通通知与联动（如：MR 事件触发自动化、部署完成回调）。
五 规模化治理与运维
- 建立分支命名规范（如：feature/、bugfix/、release/、hotfix/）、标签规范（如：vX.Y.Z）与提交信息规范，并定期清理已合并分支与无效标签，保持仓库整洁。
- 制定备份与恢复策略（定期备份实例与仓库数据、演练恢复流程），保障多项目环境下的可用性与可恢复性。
- 对monorepo或跨仓依赖：在 Ubuntu 开发机上使用 Repo + manifest.xml 管理多仓拉取、分支与同步，保持工程一致性与本地开发效率。
