如何通过GitLab API将自定义分支合并至另一分支

方案1：创建临时Merge Request并自动合并 #

GitLab API没有直接合并两个分支的端点，但可以通过创建临时MR并立即合并的方式实现需求：

• 第一步：调用POST /projects/:id/merge_requests接口，创建从BRANCH-1到BRANCH-2的MR，核心参数设置：
  • source_branch: BRANCH-1
  • target_branch: BRANCH-2
  • title: 可设为临时标识，比如Auto-merge BRANCH-1 into BRANCH-2
• 第二步：调用PUT /projects/:id/merge_requests/:merge_request_iid/merge接口，合并刚创建的MR，可根据需求添加参数：比如should_remove_source_branch控制是否删除源分支，merge_when_pipeline_succeeds设置等待流水线成功后再合并
• 可选操作：合并完成后，调用DELETE /projects/:id/merge_requests/:merge_request_iid删除临时MR记录

方案2：通过CI/CD Pipeline执行合并命令 #

如果项目允许CI/CD执行Git操作，可通过触发自定义流水线完成合并：

• 第一步：调用POST /projects/:id/pipeline接口，触发流水线并传递分支变量：
  • variables[SOURCE_BRANCH]: BRANCH-1
  • variables[TARGET_BRANCH]: BRANCH-2
• 第二步：在项目的.gitlab-ci.yml中添加合并任务：

merge-branches:
  stage: custom
  only:
    - pipelines
  script:
    - git config --global user.name "GitLab CI Bot"
    - git config --global user.email "ci-bot@your-domain.com"
    - git checkout $TARGET_BRANCH
    - git pull origin $TARGET_BRANCH
    - git merge --no-ff $SOURCE_BRANCH
    - git push origin $TARGET_BRANCH
  when: manual # 可选，设为manual需手动触发，移除则自动执行

注意：需确保CI Runner拥有仓库推送权限（比如配置部署令牌或SSH密钥）

方案3：文件级手动合并（仅适用于简单场景） #

如果分支间无复杂冲突，可通过API获取两个分支的文件差异，手动合并后更新目标分支。但这种方式操作繁琐，容易遗漏冲突，仅适合文件结构简单的场景，不推荐常规使用。

内容的提问来源于stack exchange，提问作者Starshov