Ubuntu 上 GitLab 多用户协作实操指南

一 环境准备与安装

• 准备一台 Ubuntu 20.04/22.04 服务器，建议至少 4 核 CPU、4 GB 内存、25 GB 磁盘，并开放 80/443/22 端口（UFW 示例：sudo ufw allow 80,443,22）。
• 安装依赖并添加仓库：
  sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata perl
  curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
• 安装 GitLab CE 并配置外部访问地址（将 your_domain_or_ip 替换为实际域名或 IP）：
  sudo EXTERNAL_URL=“http://your_domain_or_ip” apt-get install -y gitlab-ce
• 使配置生效：
  sudo gitlab-ctl reconfigure
  以上步骤完成后，浏览器访问设置的 external_url 完成初始化。

二 用户与权限体系

• 创建用户：管理员在 GitLab Web 界面创建账号，或进入控制台创建：
  sudo gitlab-rails console
  user = User.new(name: “Alice”, username: “alice”, email: “alice@example.com”, password: “StrongPass!23”, password_confirmation: “StrongPass!23”)
  user.save!
• 组织与授权：创建 Group（组） 并将用户加入，按项目为成员分配角色（如 Guest/Reporter/Developer/Maintainer/Owner），实现跨项目的统一权限管理。
• 仓库可见性：项目可设为 Private/Internal/Public，配合组成员权限实现精细访问控制。
• 建议：为关键分支设置 分支保护（禁止直接 push/合并，必须通过 Merge Request 审核）。

三 协作流程与日常命令

• 克隆仓库（SSH 推荐）：
  git clone git@your_domain_or_ip:group/project.git
• 本地开发：
  git checkout -b feature/login

  编辑文件

  git add .
  git commit -m “feat: add login validation”
  git push origin feature/login
• 代码评审与合并：在 GitLab 项目页面进入 Merge Requests → New merge request，选择源分支与目标分支，指派评审人，讨论通过后点击 Merge 完成合并。
• 问题跟踪：使用 Issues/Milestones 进行任务分配、进度跟踪与看板管理。

四 自动化与质量保障

• 在仓库根目录添加 .gitlab-ci.yml 定义流水线：
  stages:

  • build
  • test
  • deploy

  build_job:
  stage: build
  script:
  - echo “Building…”

  test_job:
  stage: test
  script:
  - echo “Running tests…”

  deploy_job:
  stage: deploy
  script:
  - echo “Deploying…”
  每次推送将自动触发 CI/CD，用于构建、测试与部署，保障协作质量与交付效率。

五 安全与运维要点

• 通信安全：配置 HTTPS/SSL（放置证书后更新 gitlab.rb 的 external_url 为 https://… 并重新配置）。
• 邮件通知：在 /etc/gitlab/gitlab.rb 中启用并配置 SMTP，用于注册确认、MR 评论通知等。
• 备份与恢复：定期执行备份（如 gitlab-backup create），妥善保存备份与配置文件，确保可快速恢复。
• 防火墙与服务：保持 80/443/22 放行，确保 gitlab-ctl reconfigure 与必要的重启操作生效。