Azure DevOps Pipeline：windows-latest代理无法提交变更至仓库

核心错误原因 #

1. Job间工作目录不共享：Azure Pipelines每个Job都是独立运行环境，默认不会继承上一个Job的文件变更，导致第二个Job无法看到第一个Job修改的JSON文件，出现nothing to commit。
2. 分支路径格式错误：$(Build.SourceBranch)返回的是完整引用路径（如refs/heads/TestPolicies），直接用于git checkout会触发路径不匹配错误。
3. 未在推送Job中检出代码：第二个Job没有执行checkout: self，导致Git处于分离HEAD状态，无法正常推送分支。

修改方案 #

完整修改后的YAML配置 #

trigger: none

pool:
  vmImage: 'windows-latest'

variables:
  # Path vars
  PoliciesMainBicepFilePath: "$(Agent.BuildDirectory)/s/TestBicepPoliciesEnv/main.bicep"
  PoliciesMainParametersFilePath: "$(Agent.BuildDirectory)/s/TestBicepPoliciesEnv/main.parameters.jsonc"
  ResourceGroup: "RG_XXXXX_IaC"
  AzureResourceManagerConnection: 'XXXXXXX'

  # GIT stuff
  SubscriptionId: "9536d2f5-xxxx-4cf8-ac41-xxxxxxxxxx"
  jsonFilePath: '$(System.DefaultWorkingDirectory)\TestBicepPoliciesEnv\customPolicies\'
  repoUrl: 'https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@xxxxxx-be.visualstudio.com/XXXXX%20INFRA%20IaC/_git/XXXXX%20INFRA%20IaC'
  branchName: '$(Build.SourceBranchName)' # 改用纯分支名，避免完整refs路径
  commitMessage: "Updating_parameters_in_Policy_JSON_files"
  System.Debug: true

parameters:
- name: Tag1Name
  displayName: 'Required Tag 1 name'
  type: string
  default: 'Owner'
- name: Tag2Name
  displayName: 'Required Tag 2 name'
  type: string
  default: 'Environment'
- name: Tag3Name
  displayName: 'Required Tag 3 name'
  type: string
  default: 'App'
- name: Tag4Name
  displayName: 'Required Tag 4 name'
  type: string
  default: 'Region'

stages:
  - stage: "Deploy_policies"
    jobs:
      - job: Customize_and_Push_policies
        displayName: Customize policies and push changes
        steps:
          - checkout: self

          - powershell: |
              Write-Host "Executing replaceTagsPolicy.ps1"
              ls $(System.DefaultWorkingDirectory)\TestBicepPoliciesEnv\
              .\TestBicepPoliciesEnv\replaceTagsPolicy.ps1 -Tag1Name $env:Tag1Name -Tag2Name $env:Tag2Name -Tag3Name $env:Tag3Name -Tag4Name $env:Tag4Name
              # 提前检查文件修改状态
              git status
            env:
              Tag1Name: ${{ parameters.Tag1Name }}
              Tag2Name: ${{ parameters.Tag2Name }}
              Tag3Name: ${{ parameters.Tag3Name }}
              Tag4Name: ${{ parameters.Tag4Name }}

          - powershell: |
              # 配置Git完整身份信息
              git config --global user.email "xxxxxxxxxxxxx@xxxxxx.com"
              git config --global user.name "Pipeline Automation"

              # 添加修改的文件
              git add ${{ variables.jsonFilePath }}

              # 检查是否有实际变更，避免无变更时执行commit报错
              $hasChanges = git status --porcelain
              if ($hasChanges) {
                git commit -m "${{ variables.commitMessage }}"
                Write-Host "Committed changes successfully"

                # 更新远程仓库URL为带PAT的地址
                git remote set-url origin ${{ variables.repoUrl }}

                # 推送至原分支
                git push origin ${{ variables.branchName }}
                Write-Host "Pushed changes to branch ${{ variables.branchName }}"
              } else {
                Write-Host "No changes detected, skipping commit and push"
              }

关键修改点说明 #

1. 合并Job：将原有的两个Job合并为一个，确保修改后的文件始终在同一工作目录中，避免跨Job文件传递的问题。
2. 使用Build.SourceBranchName：直接获取纯分支名（如TestPolicies），替代完整的refs/heads/TestPolicies路径，解决Git checkout和推送的路径匹配错误。
3. 添加变更检查：通过git status --porcelain判断是否有文件变更，避免无变更时执行commit导致Pipeline失败。
4. 完善Git身份配置：同时设置Git用户名和邮箱，避免因身份信息不全导致的提交失败。

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