如何区分Azure Pipelines构建为手动触发还是API调用触发

直接给结论：你期望的无自定义配置、不绑定用户名的内置判断方案是存在的，不需要硬编码触发者信息，也不需要强制传自定义变量。

方案1：使用内置服务主体判断变量（推荐，零额外配置） #

Azure Pipelines 原生提供预定义变量System.ServicePrincipalId，可以直接区分自动化身份触发和普通用户手动触发，完全匹配你的场景：

• 当管道由发布定义的无代理API任务（使用服务连接/托管标识/服务主体身份调用）触发时，该变量会自动填充为调用方服务主体的对象ID，值非空
• 当管道由用户在门户手动点击运行（使用个人AAD/AD账号身份）时，该变量值为空

你不需要提前做任何配置，直接写条件表达式即可：

• 匹配API触发场景的条件：

ne(variables['System.ServicePrincipalId'], '')

• 匹配用户手动门户触发场景的条件：

eq(variables['System.ServicePrincipalId'], '')

注意：该变量支持Azure DevOps Services、Azure DevOps Server 2022及以上版本，覆盖绝大多数当前使用的环境。

方案2：低版本环境兼容方案（自定义触发参数） #

如果你使用的是2022以前的旧版本Azure DevOps Server，无法使用System.ServicePrincipalId变量，可以用成本极低的自定义参数方案，不需要绑定用户名：

• 给构建管道添加一个布尔类型的运行时参数，命名为IsApiTriggered，默认值设为false
• 在发布定义的无代理API调用触发构建的请求体中，传递该参数值为true，示例请求片段：

{
  "definition": {"id": 你的构建管道ID},
  "parameters": "{\"IsApiTriggered\": true}"
}

• 管道中直接通过参数判断即可：
  • API触发条件：eq(${{ parameters.IsApiTriggered }}, true)
  • 手动触发条件：eq(${{ parameters.IsApiTriggered }}, false)

你之前构思的方案问题说明 #

• 基于触发用户名（比如eq(triggered-by, "Joe")）判断：维护成本极高，人员变动、服务账号轮换都需要修改管道条件，完全不推荐
• 直接判断eq(variables['Build.Reason'], 'api')：Azure Pipelines的Build.Reason预定义变量没有api这个枚举值，默认情况下API调用触发和手动门户触发的Build.Reason值均为Manual，直接写这个条件无法生效。

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