Azure DevOps YAML管道BuildApi如何获取stage的dependsOn值及阶段依赖图

开发者阿泽

2026-10-4

Azure DevOps 构建阶段依赖关系解析方案

buildApi.getBuildTimeline() 返回的 TimelineRecord 数组本身已包含阶段依赖的全量信息，无需调用额外接口，TimelineRecord.order 仅代表UI展示顺序，和流水线定义的 dependsOn 依赖无关联，你可以按以下逻辑解析：

核心解析步骤

第一步：过滤 TimelineRecord 数组，仅保留 type 为 Stage 的条目，所有流水线阶段都在该子集内
第二步：读取每个阶段对应 TimelineRecord 实例的 dependencies 字段，该字段为数组，每个元素存储了当前阶段依赖的上游阶段ID和名称
第三步：将依赖ID和阶段条目做映射，即可得到完整的阶段依赖关系

示例代码（Node.js）

// 调用接口获取时间线数据
const buildTimeline = await buildApi.getBuildTimeline(项目名称, 构建ID);
// 筛选所有阶段条目
const allStages = buildTimeline.records.filter(record => record.type === 'Stage');
// 构建阶段依赖映射表
const stageDepMap = new Map();

allStages.forEach(stage => {
  // 提取当前阶段的依赖ID列表
  const depIdList = stage.dependencies?.map(depItem => depItem.id) || [];
  // 转换为依赖阶段的名称，方便直接使用
  const depNameList = depIdList
    .map(depId => allStages.find(stageItem => stageItem.id === depId)?.name)
    .filter(Boolean);
  
  stageDepMap.set(stage.name, {
    stageId: stage.id,
    dependencies: depNameList,
    currentStatus: stage.state
  });
});