分支合并操作指引

提示

请确保项目中已配置 .gitlab-ci.yml 文件，详见 CI配置说明

Release 合并到 Main

在 GitLab 中，分支合并通过 Merge Request（MR）完成。以下是 release → main 的完整操作流程：

1. 创建 Merge Request

在项目的 GitLab 页面中，点击左侧菜单的 "Merge Requests" 选项。

select-mr.png

点击右上角的 "New merge request" 按钮。

new_mr.png

2. 配置合并分支

选择合并的源分支和目标分支：

• 源分支（Source branch）：release
• 目标分支（Target branch）：main

mr_release_to_main.png

3. 填写 MR 信息

填写 MR 的标题和描述：

• 标题：简洁描述本次发布内容
• 描述：详细说明合并目的、变更内容、影响范围等

确认信息无误后，点击 "Create merge request" 按钮。

mr_detail.png

4. CI/CD 管道验证

创建 MR 后，GitLab 会自动触发 CI/CD 管道进行代码验证：

mr_exec.png

可以点击 Hash 值 或 CI/CD pipelines 查看详细的执行日志。

mr_ci_detail.png

5. 审核与合并

当 CI/CD 管道运行成功且审核人员确认通过后，点击 "Merge" 按钮完成合并。

mr_confirm.png

6. 合并后处理

合并完成后，GitLab 会自动触发合并后的管道流程：

mr_post_ci.png

管道执行完成后的状态：

mr_post_ci_finished.png

7. 验证合并结果

回到代码库页面，切换到 "Branches" 页面，确认：

• 合并后的代码已更新
• main 与 release 分支代码保持一致

mr_post_main_release_sync.png

8. 查看CI产物

在合并完成后，可以查看 CI/CD 生成的产物，如 Tag 和 Release。

project_tag_release_detail.png

tag

git_tag_list.png

release

release_list.png

后续开发

合并完成后，新需求开发流程：

1. 自动创建新 Release：CI 会基于 main 自动创建新的 release 分支
2. 创建 Feature 分支：从 main 分支创建新的 feature/xxx 分支
3. 继续开发：在新的 feature 分支上进行开发

注意事项

• 确保 CI/CD 管道全部通过后再进行合并
• 合并前务必进行代码审核
• 合并后及时验证线上环境是否正常
• 遵循 分支管理规范 和 提交规范

相关文档

• 分支管理规范
• CI 配置模板