如何在Linux上使用GitLab协作开发

一、前期准备

• 系统要求：推荐使用Ubuntu、CentOS等主流Linux发行版；至少2GB RAM（推荐4GB及以上）、20GB可用存储空间；服务器需联网并开放HTTP（80端口）、HTTPS（443端口）访问权限。

二、安装GitLab

1. 安装依赖包
   根据系统类型安装必要组件（以Ubuntu/Debian为例）：

   sudo apt-get update
   sudo apt-get install -y curl openssh-server ca-certificates tzdata perl
   

   CentOS/RHEL系统需额外安装policycoreutils-python和postfix（用于邮件通知）：

   sudo yum install -y curl policycoreutils-python openssh-server postfix
   sudo systemctl enable postfix &
       &
        sudo systemctl start postfix
   

2. 添加GitLab仓库并安装

   • Ubuntu/Debian：通过脚本添加GitLab仓库，再安装社区版（CE）：

     curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
     sudo apt-get install gitlab-ce
     

   • CentOS/RHEL：同理添加仓库后安装：

     curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
     sudo yum install gitlab-ce
     

3. 配置与启动GitLab
   编辑配置文件/etc/gitlab/gitlab.rb，设置external_url（如http://your_server_ip，若用域名则替换为域名）；运行以下命令使配置生效并启动服务：

   sudo gitlab-ctl reconfigure  # 应用配置
   sudo gitlab-ctl start        # 启动GitLab
   

   访问http://your_server_ip，使用默认管理员账号root及初始密码（配置时设置）登录。

三、配置GitLab协作基础

1. 创建项目
   登录GitLab后，点击右上角“New Project”，填写项目名称（如my-team-project）、描述，选择可见性（Private/Internal/Public，团队协作推荐Private），点击“Create Project”。

2. 添加团队成员
   进入项目页面，左侧菜单选择“Members”，点击“Invite member”，输入成员GitLab账号邮箱或用户名，分配角色（Owner（管理员）、Developer（开发/推送代码）、Reporter（查看/评论）等），点击“Invite”。

3. 配置SSH密钥（免密推送）

   • 本地终端生成密钥对（若已有可跳过）：

     ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
     

   • 复制公钥内容（~/.ssh/id_rsa.pub），登录GitLab，进入“Preferences”→“SSH Keys”，粘贴公钥并保存。

四、团队协作开发流程

1. 克隆项目到本地
   成员收到邀请后，通过以下命令克隆项目仓库：

   git clone git@gitlab.com:team/my-team-project.git
   cd my-team-project
   

2. 创建功能分支
   从develop分支（推荐用于日常开发，若无则从main衍生）创建专属功能分支（命名规范：feature/your-task-name）：

   git checkout develop       # 切换到develop分支
   git pull origin develop    # 拉取最新代码
   git checkout -b feature/user-login  # 创建并切换到新分支
   

3. 开发与提交代码
   在本地进行代码修改，添加变更到暂存区并提交：

   git add .                  # 添加所有变更文件（或指定文件，如git add src/login.js）
   git commit -m "feat: 实现用户登录功能"  # 提交信息需清晰描述变更内容
   git push origin feature/user-login  # 推送分支到远程仓库
   

4. 发起合并请求（MR）
   登录GitLab，进入项目页面，点击“Merge Requests”→“New merge request”，选择：

   • Source branch（源分支）：feature/user-login（你的功能分支）；
   • Target branch（目标分支）：develop（目标分支，用于整合功能）；
     填写MR标题（如“实现用户登录功能”）、描述（说明变更内容、关联任务ID等），点击“Create merge request”。

5. 代码审查与合并

   • 团队成员（尤其是Maintainer/Developer角色）在MR页面查看代码变更，通过“Comments”功能提出修改意见；
   • 你根据反馈修改代码，重复“提交→推送”步骤（无需重新创建MR，GitLab会自动更新）；
   • 审查通过后，由Maintainer点击“Merge”按钮将功能分支合并到develop分支，合并后可选择删除源分支（避免分支冗余）。

五、进阶协作优化

1. 分支管理策略
   推荐使用以下分支模型提升协作效率：

   • main：生产环境代码（稳定，仅合并经过测试的develop分支）；
   • develop：日常开发集成分支（整合各功能分支）；
   • feature/*：功能开发分支（从develop衍生，如feature/user-profile）；
   • bugfix/*：缺陷修复分支（从develop或main衍生，如bugfix/login-error）；
   • release/*：预发布分支（用于测试即将上线的内容，从develop衍生）；
   • hotfix/*：紧急修复分支（从main衍生，快速解决线上问题后合并到main和develop）。

2. 配置CI/CD自动化
   在项目根目录创建.gitlab-ci.yml文件，定义构建、测试、部署流程（示例）：

   stages:
     - build
     - test
     - deploy
   
   build_job:
     stage: build
     script:
       - echo "Building the project..."
       - npm install &
       &
        npm run build
   
   test_job:
     stage: test
     script:
       - echo "Running tests..."
       - npm test
   
   deploy_job:
     stage: deploy
     script:
       - echo "Deploying to production..."
       - scp -r ./dist user@server:/var/www/html
     only:
       - main  # 仅在main分支合并时触发
   

   推送.gitlab-ci.yml到远程仓库，GitLab Runner会自动执行CI/CD流程（需提前安装并注册Runner）。

3. 使用Issue跟踪任务
   在项目页面左侧菜单点击“Issues”，创建任务（标题、描述、分配成员、设置截止日期、添加标签如bug/enhancement），关联MR（在MR页面点击“Link issue”，输入任务编号，如Closes #12，合并MR后任务自动关闭）。

六、注意事项

• 禁止直接在main/develop分支开发：所有变更必须通过功能分支提交MR，确保代码经过审查；
• 提交信息规范化：使用清晰格式（如feat: 实现XX功能、fix: 修复XXbug、docs: 更新XX文档），便于追踪变更历史；
• 定期同步远程分支：开发前执行git pull origin develop，避免本地分支与远程分支冲突；
• 备份数据：通过GitLab管理界面配置定期备份（如每天凌晨2点），防止数据丢失。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！