在 Debian 上使用 GitLab 进行团队协作的实操指南
一 环境准备与安装
- 更新系统并安装依赖：sudo apt update && sudo apt upgrade -y；sudo apt install -y curl openssh-server ca-certificates postfix tzdata。
- 添加 GitLab 官方仓库并安装社区版：
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo EXTERNAL_URL=“https://gitlab.example.com” apt install -y gitlab-ce
- 配置与启动：编辑 /etc/gitlab/gitlab.rb 设置 external_url；执行 sudo gitlab-ctl reconfigure；如需开机自启可执行 sudo systemctl enable gitlab && sudo systemctl start gitlab。
- 防火墙放行：sudo ufw allow 80,443/tcp && sudo ufw reload。
- 可选 HTTPS：使用 Certbot 为 Nginx 申请证书（若使用外部 Nginx）：sudo apt install certbot python3-certbot-nginx；sudo certbot --nginx -d gitlab.example.com。
二 团队项目协作流程
- 创建项目与权限：在 GitLab 中新建项目，设置可见性为私有/内部/公开；在“成员”中添加团队成员并分配角色（如开发者/维护者/所有者）。
- 本地克隆与分支开发：git clone <项目地址>；git checkout -b feature/x；开发完成后 git add .；git commit -m “feat: x”；git push origin feature/x。
- 代码审查与合并：在 Web 界面创建合并请求 Merge Request（支持指派评审、讨论、变更集对比、流水线结果展示）；评审通过后合并到目标分支。
- Fork + Merge Request 模式：协作者先 Fork 项目，在个人 Fork 中开发并推送分支，再向原项目发起 MR；适合开源或跨组织协作。
三 自动化协作 CI/CD
- 安装 GitLab Runner（Debian 服务器或专用 Runner 机）：
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.deb.sh | sudo bash
sudo apt-get install -y gitlab-ci-multi-runner
- 注册 Runner：在项目“Settings > CI/CD > Runners”获取注册令牌与 URL，执行注册命令，选择执行器（如 shell/docker），并在需要时限制 tags 与并发。
- 定义流水线：在项目根目录创建 .gitlab-ci.yml，示例：
stages: [build, test, deploy]
build:
stage: build
script: ./gradlew build || make build
test:
stage: test
script: ./gradlew test || make test
deploy_prod:
stage: deploy
script: ./deploy.sh prod
only: [main]
- 提交后自动触发流水线，结果会显示在 MR 页面，未通过时可阻止合并，保障协作质量。
四 权限与代码质量保障
- 分支保护：在项目“Settings > Repository > Protected branches”设置 main/develop 的保护策略（如仅允许维护者合并、要求 MR 审批与流水线通过）。
- 议题与里程碑：使用议题 Issues管理任务与缺陷，配合里程碑 Milestones进行迭代规划；通过评论、指派、标签提升协作效率。
- 代码审查与讨论：MR 支持行级评论、变更对比、评审请求与解决讨论；结合流水线结果与静态检查/安全扫描结果决定是否可合并。
- 通知与邮件：在“Settings > Notifications”与 SMTP 配置中启用邮件提醒，确保成员及时收到评审、合并与流水线事件。
五 运维与安全最佳实践
- 备份与恢复：定期执行备份（如 gitlab-backup create），妥善保存备份文件；恢复时确保备份版本与当前 GitLab 版本一致，避免不兼容。
- 安全加固：优先使用 HTTPS/TLS；限制对外暴露端口与 IP；为管理员与关键成员启用SSH 密钥登录；必要时关闭 GitLab 自带 Nginx 并由外部反向代理统一承载。
- 性能与高可用：根据团队规模调整 CPU/内存/存储，使用 SSD 提升 I/O；必要时引入对象存储与缓存优化；监控资源使用并按需扩容。