如何使用Azure DevOps NuGet包排队构建并仅运行特定阶段？

1. BuildHttpClient 无法指定运行特定阶段 #

BuildHttpClient 对应 Azure DevOps 旧版的构建模型（如XAML构建、经典构建），不支持控制YAML管道的阶段执行。你当前的代码只能触发整个构建定义的所有阶段，无法实现仅运行特定阶段的需求。

2. 使用 PipelinesHttpClient 的正确方案 #

解决 Guid 格式异常 #

出现的「Guid should contain 32 digits with 4 dashes」异常，原因是传入的projectId或pipelineId格式错误。必须传入标准的Guid字符串（可从Azure DevOps项目设置中复制项目ID，或通过API获取管道ID），不能传入项目/管道名称或其他非Guid格式的值。

实现仅运行特定阶段 #

PipelinesHttpClient 仅提供StagesToSkip属性，没有直接的StagesToRun参数。要实现仅运行指定阶段，需先获取管道的所有阶段列表，再计算出需要跳过的阶段：

• 方式一：通过管道的最新运行记录获取阶段列表
• 方式二：解析管道的YAML定义获取阶段名称

以下是示例代码：

var pipelinesHttpClient = _vssConnection.GetClient<PipelinesHttpClient>();
// 确保projectId为标准Guid格式
var projectGuid = new Guid(projectId);

// 获取管道详情
var pipeline = await pipelinesHttpClient.GetPipelineAsync(projectGuid, pipelineId);

// 从最新运行记录中获取所有阶段名称
var latestRun = (await pipelinesHttpClient.GetPipelineRunsAsync(projectGuid, pipelineId, top: 1)).FirstOrDefault();
var allStages = latestRun?.Stages.Select(s => s.Name).ToList();

// 指定需要运行的阶段
var targetStages = new List<string> { "生产部署", "集成测试" };
// 计算需要跳过的阶段
var stagesToSkip = allStages?.Where(stage => !targetStages.Contains(stage)).ToList();

// 排队运行指定阶段
await pipelinesHttpClient.RunPipelineAsync(
    new RunPipelineParameters
    {
        StagesToSkip = stagesToSkip
    },
    projectGuid,
    pipelineId);

补充说明 #

如果管道还没有运行记录，可调用GetPipelineDefinitionAsync获取YAML定义内容，使用YAML解析库（如YamlDotNet）解析出所有阶段名称；同时确保服务账号拥有管道读取、排队的权限。

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