Azure发布管道失败后，如何向触发提交添加通知评论？

核心方案 #

通过Azure DevOps REST API结合管道中的脚本任务，在Salesforce沙箱部署失败时，自动向触发部署的提交记录添加评论并@对应开发者，实现直接通知。

具体步骤 #

1. 添加失败触发的任务 #

在你的Salesforce部署任务之后，新增一个任务并设置条件为仅当前一任务失败时运行（Azure DevOps中可通过任务的「运行条件」选择「只有当之前的任务失败时」）。

2. 获取管道上下文参数 #

任务中需用到以下预定义变量：

• $(Build.SourceVersion)：触发管道的提交记录ID
• $(Build.RequestedForEmail)：提交作者的邮箱（用于@通知）
• $(System.TeamFoundationCollectionUri)：Azure DevOps组织地址
• $(System.TeamProject)：当前项目名称
• $(Build.Repository.ID)：代码仓库ID
• $(System.AccessToken)：管道服务账户的访问令牌

3. 编写脚本调用REST API添加评论 #

以下是PowerShell示例脚本（需在任务中选择「PowerShell」类型，启用「允许脚本访问OAuth令牌」）：

# 构造评论内容
$commitId = "$(Build.SourceVersion)"
$authorEmail = "$(Build.RequestedForEmail)"
$commentContent = "⚠️ @$authorEmail 你的提交 ($commitId) 触发的Salesforce沙箱部署失败，请查看管道日志：$(Build.BuildUri)"

# 构建API请求地址
$apiUrl = "$(System.TeamFoundationCollectionUri)$(System.TeamProject)/_apis/git/repositories/$(Build.Repository.ID)/commits/$commitId/comments?api-version=7.1-preview.3"

# 构造请求体
$requestBody = @{
    content = $commentContent
} | ConvertTo-Json

# 调用API添加评论
Invoke-RestMethod -Uri $apiUrl -Method Post `
    -Headers @{Authorization = "Bearer $(System.AccessToken)"} `
    -Body $requestBody `
    -ContentType "application/json"

4. 配置权限 #

确保Azure DevOps的Project Collection Build Service账户拥有Git仓库的贡献者权限，允许其向提交记录添加评论。可在项目设置的「权限」页面中配置。

5. 验证效果 #

提交一段会导致Salesforce部署失败的代码，触发管道后检查对应提交记录，确认是否收到评论通知。

优化建议 #

• 若单次推送包含多个提交，可遍历$(Build.SourceVersionMessage)中的所有提交ID，批量添加评论
• 在评论中补充部署失败的具体错误摘要（可从Salesforce部署日志中提取）
• 结合Azure DevOps的通知设置，让开发者收到评论的邮件/Teams推送提醒

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