Azure DevOps分支流水线自动化：工作项中的任务状态检查与自动化处理

我来帮你梳理下怎么实现这个需求，核心思路就是用Azure DevOps的**Gate（门控）**配合REST API的Patch请求来搞定工作项状态的自动变更，具体步骤和细节如下：

1. 用门控检查目标任务ID的状态 #

咱们首先在流水线的部署阶段前加一个**Gate（门控）**任务，它的作用就是先确认任务的当前状态：

• 在门控里编写PowerShell或Bash脚本，调用Azure DevOps的工作项查询API：

  # Bash示例：查询工作项状态
  curl -u :$PAT https://dev.azure.com/你的组织名/你的项目名/_apis/wit/workitems/你的任务ID?api-version=7.1-preview.3 | jq '.fields."System.State"'
  

  或者PowerShell版本：

  # PowerShell示例：查询工作项状态
  $headers = @{ Authorization = "Bearer $env:SYSTEM_ACCESSTOKEN" }
  $response = Invoke-RestMethod -Uri "https://dev.azure.com/你的组织名/你的项目名/_apis/wit/workitems/你的任务ID?api-version=7.1-preview.3" -Headers $headers -Method Get
  $currentState = $response.fields.'System.State'
  

• 解析返回结果里的System.State字段，判断任务当前是closed还是active。

2. 若任务已关闭，调用Patch API重新激活 #

如果查询到任务状态是closed，就用Patch API更新它的状态为active：

• 请求地址：PATCH https://dev.azure.com/你的组织名/你的项目名/_apis/wit/workitems/你的任务ID?api-version=7.1-preview.3
• 请求体要按JSON Patch格式构造：

  [
    {
      "op": "replace",
      "path": "/fields/System.State",
      "value": "active"
    }
  ]
  

• 脚本示例（PowerShell）：

  $patchBody = '[{ "op": "replace", "path": "/fields/System.State", "value": "active" }]'
  Invoke-RestMethod -Uri "https://dev.azure.com/你的组织名/你的项目名/_apis/wit/workitems/你的任务ID?api-version=7.1-preview.3" -Headers $headers -Method Patch -Body $patchBody -ContentType "application/json-patch+json"
  

• 记得要给流水线配置足够的权限：可以用系统访问令牌（SYSTEM_ACCESSTOKEN）或者个人访问令牌（PAT），确保拥有工作项的读写权限。

3. 门控放行后执行部署阶段 #

当门控确认任务状态已经是active（不管是本来就活跃，还是刚被重新激活），就会自动放行，流水线会正常进入后续的部署阶段，执行你原本的部署任务即可。

4. 部署完成后关闭任务 #

在流水线的最后一个阶段（部署全部完成后），添加一个脚本任务，再次调用Patch API把任务状态改回closed：

• 只需要把请求体里的value改成closed就行：

  [
    {
      "op": "replace",
      "path": "/fields/System.State",
      "value": "closed"
    }
  ]
  

• 脚本逻辑和之前激活任务的逻辑基本一致，替换状态值即可。

一些实用小提示 #

• 把组织名、项目名、任务ID做成流水线变量，这样后续修改起来更灵活，不用硬编码在脚本里。
• 门控可以设置重试策略，比如每隔2分钟重试一次，最多重试3次，避免因网络延迟或状态同步慢导致的误判。
• 测试的时候可以先手动触发流水线，观察API调用的日志，确保状态变更符合预期。

备注：内容来源于stack exchange，提问作者Alok Ranjan