如何使用GitLab进行版本控制

使用 GitLab 进行版本控制的实操指南

快速上手流程

• 创建项目：登录 GitLab，点击 New project，选择 Create blank project，填写项目名与可见性（Private/Internal/Public）。
• 克隆仓库：在项目首页复制 SSH/HTTPS 地址，执行
  git clone <仓库地址>
  cd <项目目录>
• 提交与推送：
  git add .
  git commit -m “Initial commit”
  git push -u origin main
  若远程默认分支是 master，请将命令中的 main 替换为 master。
• 拉取更新：
  git pull origin main
  以上流程适用于 SaaS（gitlab.com） 与自托管实例，关键在于使用项目页面提供的克隆地址与正确的默认分支名。

分支管理与合并请求

• 分支命名规范：
  • 主分支：main/master
  • 功能分支：feature/功能名（例：feature/user-auth）
  • 修复分支：fix/问题编号-描述（例：fix/123-login-error）
  • 紧急修复：hotfix/问题编号-描述
  • 发布分支：release/版本号（例：release/1.0.0）
• 典型协作流程：
  • 创建并开发：git checkout -b feature/new-feature main
  • 推送分支：git push origin feature/new-feature
  • 在 GitLab 创建 Merge Request（MR），指定源分支与目标分支（如 main），进行代码审查与讨论。
  • 审核通过后合并，并在合并后删除已合并的远程功能分支。
• 分支保护：将 main/master 设为受保护分支，仅允许通过 MR 合并，并可配置审批规则、状态检查等，保障主干稳定。
• 合并策略：根据团队习惯选择 –ff-only / --no-ff / rebase 等策略，保持提交历史清晰。
  以上做法与命名规范可显著提升协作效率与代码质量。

标签与版本发布

• 创建标签（里程碑/版本）：
  git tag -a v1.0.0 -m “Release v1.0.0”
  git push origin v1.0.0
• 查看与切换标签：
  git tag -l
  git checkout v1.0.0
• 回滚策略：优先使用 git revert 创建“撤销提交”，避免直接改写历史；如需回到某次提交的状态，也可检出该提交（注意分离 HEAD 场景）。
• 发布流程建议：在 main/master 稳定后打 Tag，配合 CI/CD 自动部署到相应环境，并在 MR 或 Release 说明中记录变更要点。
  标签与回滚的规范用法有助于可追溯的版本发布与快速恢复。

CI/CD 自动化

• 在项目根目录创建 .gitlab-ci.yml，定义构建、测试、部署等阶段：
  stages:

  • build
  • test
  • deploy

  build_job:
  stage: build
  script:
  - echo “Building…”
  - ./gradlew build

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

  deploy_job:
  stage: deploy
  script:
  - echo “Deploying to $CI_ENVIRONMENT_NAME…”
  environment: production

• 运行流水线：每次 push 或 MR 都会触发；确保已注册并运行 GitLab Runner，为不同环境配置变量与保护规则。
  通过 CI/CD 将构建、测试、部署纳入版本控制闭环，可显著降低人工失误并加速交付。

自托管 GitLab 与日常维护

• 安装与启动（示例）：
  • Ubuntu/Debian：
    curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
    sudo EXTERNAL_URL=“http://your-server-ip” apt-get install gitlab-ce
    sudo gitlab-ctl reconfigure
  • CentOS/RHEL：
    curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
    sudo EXTERNAL_URL=“http://your-server-ip” yum install gitlab-ce
    sudo gitlab-ctl reconfigure
• 配置要点：在 /etc/gitlab/gitlab.rb 中设置 external_url，按需配置 SMTP、防火墙与端口（常见为 80/443/22）。
• 备份与恢复：定期执行备份（如 gitlab-rake gitlab:backup:create），妥善保存备份与配置文件，确保可快速恢复。
• 安全建议：启用 HTTPS/SSL、限制管理员访问、定期升级实例版本。
  以上步骤覆盖自托管的关键环节，适合对代码与合规有更高要求的团队。