如何检查Azure DevOps Pipeline的stageList中是否包含checkout任务

问题核心 #

你需要在扩展模板中接收stageList参数，自动检查每个Job的Steps中是否包含Checkout任务，若缺失则插入checkout: self，确保用户原始管道即使未定义Checkout，也能正常检出自身代码，同时避免重复添加。

错误原因分析 #

你之前的实现存在两个关键问题：

1. 路径引用错误：parameters.buildStages.stage.jobs.job.steps.task.value是无效路径，无法正确访问循环中的Stage/Job/Steps对象，必须通过each循环的迭代变量（如stage、job）来访问对应层级的内容。
2. 检查对象错误：Checkout是独立的步骤类型（结构为- checkout: xxx），而非task类型，因此不能通过检查task.value来判断是否存在Checkout任务。

正确实现模板 #

以下是修正后的模板代码，可实现需求：

parameters:
- name: buildStages
  type: stageList
  default: []

stages:
- ${{ each stage in parameters.buildStages }}:
  - stage: ${{ stage.stage }}
    # 保留Stage级的原始属性（如displayName、variables、condition等）
    ${{ each pair in stage }}:
      ${{ if not(contains('stage,jobs', pair.key)) }}:
        ${{ pair.key }}: ${{ pair.value }}
    jobs:
    - ${{ each job in stage.jobs }}:
      - job: ${{ job.job }}
        # 保留Job级的原始属性（如displayName、variables、pool、timeoutInMinutes等）
        ${{ each pair in job }}:
          ${{ if not(contains('job,steps', pair.key)) }}:
            ${{ pair.key }}: ${{ pair.value }}
        steps:
          # 检查当前Job的Steps中是否存在Checkout步骤
          ${{ if not(any(job.steps, lambda step: contains(step, 'checkout'))) }}:
            - checkout: self
          # 追加用户原始的Steps
          ${{ job.steps }}

关键逻辑说明 #

1. Checkout任务检查：使用any函数遍历当前Job的所有Steps，通过contains(step, 'checkout')判断是否存在Checkout类型的步骤（无论检出的是self还是其他仓库）。
2. 避免重复添加：仅当Steps中完全没有Checkout任务时，才插入checkout: self。
3. 保留原始配置：通过遍历Stage和Job的所有属性，排除已显式处理的stage、jobs、job、steps字段后，原样保留其他配置，确保用户原始管道的所有设置不丢失。

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