如何实现develop分支自动合并至sonar-scan分支并适配Ubuntu代理？

问题背景 #

我们维护着一个feat/sonar-scan特性分支，该分支的azure-pipelines.yml包含SonarQube专属扫描配置，且出于安全要求必须在自托管Ubuntu代理（VMSS）上运行，因此无法合并至develop分支。但为了保证SonarQube扫描基于最新代码，需要定期同步develop分支的更新，而两个分支的azure-pipelines.yml差异会导致合并冲突。之前编写的自动合并脚本仅在Windows代理上生效，Ubuntu环境下无法正常运行。

现有脚本的问题分析 #

原脚本在Ubuntu环境失效主要有几个核心原因：

• Shell注释格式错误：使用了Windows批处理风格的//，而Ubuntu的Bash脚本注释需用#
• Azure DevOps默认浅克隆：默认仅拉取最近1次提交，无法完整获取分支历史导致合并失败
• 缺少Git身份配置：代理环境未设置提交者信息，导致git commit操作失败
• 合并冲突处理的环境兼容性：部分Git参数在不同系统下的行为存在差异

修复后的Ubuntu兼容自动合并脚本 #

调整后的脚本适配Ubuntu代理环境，解决了上述问题：

- script: |
    # 配置Git提交身份（Azure DevOps代理默认无此配置）
    git config --global user.name "Azure DevOps Pipeline"
    git config --global user.email "devops@example.com"

    # 拉取完整分支历史，解决浅克隆导致的合并失败问题
    git fetch origin --prune --unshallow
    git checkout feat/sonar-scan
    git pull origin feat/sonar-scan

    # 尝试合并develop分支，冲突时不终止脚本
    git merge origin/develop --no-commit --no-ff || true

    # 保留当前分支的azure-pipelines.yml，手动解决冲突
    git checkout --ours azure-pipelines.yml
    git add azure-pipelines.yml

    # 完成合并并推送至远程分支
    git commit -m "Auto-merge latest changes from develop"
    git push origin feat/sonar-scan
  displayName: '自动同步develop分支更新'
  env:
    # 启用Azure DevOps OAuth令牌，解决Git推送权限问题
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)
  # 指定在自托管Ubuntu代理池运行
  pool:
    name: 你的自托管Ubuntu代理池名称

注意：需要在Pipeline设置中开启「允许脚本访问OAuth令牌」选项，否则git push会因权限不足失败。

更优方案建议 #

1. 拆分CI配置文件 #

将公共CI逻辑（如构建、测试）抽离到azure-pipelines-base.yml，feat/sonar-scan分支的azure-pipelines.yml仅保留SonarQube扫描和代理配置，并引用基础配置：

# feat/sonar-scan分支的azure-pipelines.yml
trigger:
  - feat/sonar-scan

pool:
  name: 自托管Ubuntu代理池名称

extends:
  template: azure-pipelines-base.yml@self

steps:
  - task: SonarQubePrepare@5
    inputs:
      SonarQube: '你的SonarQube服务连接'
      scannerMode: 'MSBuild'
      projectKey: '你的项目Key'
  # 其他SonarQube专属步骤...

这种方式能大幅减少azure-pipelines.yml的冲突，合并时无需手动处理配置文件。

2. 使用Azure DevOps Pull Request自动合并 #

在Azure DevOps中创建从develop到feat/sonar-scan的Pull Request，设置自动合并规则：

• 启用「自动完成」
• 配置「自动解决可解决的冲突」
• 预设冲突解决策略：保留feat/sonar-scan分支的azure-pipelines.yml
  这种方式无需编写脚本，直接利用Azure DevOps内置功能实现自动同步。

3. 定期Cherry-Pick关键提交 #

如果develop分支的更新仅集中在业务代码，可定期将develop的关键提交cherry-pick到feat/sonar-scan分支，避免全量合并带来的冲突：

git fetch origin
git checkout feat/sonar-scan
git cherry-pick <develop分支的提交ID>

适合业务代码更新频率不高的场景。

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