如何在ADO Pipeline中更新文件并提交至Git远程仓库？

问题场景 #

• 基于Azure开发POC Pipeline，目标：有人提交更新后的JSON文件时触发Pipeline，读取文件将version属性加1，写回文件后提交回Git仓库
• Pipeline触发正常，但执行Get sources步骤后仓库处于detached HEAD状态
• 已用Python脚本完成JSON的读取、版本更新和写回，但执行git push时失败，报错：

  error: src refspec Development does not match any
  error: failed to push some refs to 'url for my source repo'
  

• 执行git branch命令时，本地和远程都看不到分支；仓库包含main（默认）、Development、Dev三个分支，当前基于Development分支开发

核心原因 #

Azure Pipeline默认会检出触发本次Pipeline的特定commit，而非完整的分支引用，导致本地处于分离HEAD状态，没有对应的本地分支，因此push时无法匹配到远程分支。

解决方案 #

1. 配置Git提交身份（必填） #

在执行任何git操作前，先设置提交者信息，避免git因身份缺失报错：

git config --global user.name "Azure Pipeline"
git config --global user.email "azure-pipeline@example.com"

2. 创建本地分支并关联远程分支 #

从当前分离HEAD状态创建本地Development分支，并关联远程的Development分支，确保push时指向正确的远程分支：

# 先拉取所有远程分支信息（如果本地没有缓存远程分支）
git fetch origin
# 创建本地Development分支并切换到该分支，同时关联远程分支
git checkout -b Development origin/Development

3. 调整Pipeline YAML配置 #

把Git操作移到Pipeline的script步骤中（比在Python脚本里用subprocess更易维护），更新后的完整YAML如下：

# Starter pipeline
trigger:
  - Development

pool:
  vmImage: ubuntu-latest

steps:
- script: echo Hello, world!
  displayName: '测试脚本执行环境'

- script: |
    echo 检查文件结构
    ls -la
    ls -la ./Scripts
    which git
    
    # 配置Git提交身份
    git config --global user.name "Azure Pipeline"
    git config --global user.email "azure-pipeline@example.com"
    
    # 拉取远程分支信息并创建本地关联分支
    git fetch origin
    git checkout -b Development origin/Development
  displayName: '初始化Git环境'

- task: PythonScript@0
  displayName: '更新JSON文件版本号'
  inputs:
    scriptSource: 'filePath'
    scriptPath: './Scripts/update_json_file.py'

- script: |
    # 提交变更并推送到远程分支
    git add ./Content/basic.json
    git commit -m 'update version number [skip ci]'
    git push origin Development
  displayName: '提交变更到远程仓库'

关键注意事项 #

• commit消息中的[skip ci]必须保留，否则推送后会再次触发Pipeline，形成无限循环
• 如果执行git checkout时仍提示找不到远程分支，可检查Pipeline的权限是否允许拉取远程分支信息

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