Azure Pipelines 跨层级template调用如何配置失败自动重试

首先明确核心规则：retryCountOnTaskFailure是task（任务）级别的专属属性，template本身只是YAML内容的静态复用单元，会在管道编译阶段直接展开成内部的steps/jobs，本身不支持直接挂载重试配置，你可以根据自己是否能修改被引用模板，选择对应方案：

方案1：可修改被引用模板（最推荐，粒度最灵活） #

直接在被引用的模板文件中新增重试相关参数，把重试规则透传给模板内的所有任务，不需要调整调用方的原有逻辑：

1. 先修正你当前调用配置的路径问题：${{variables['System.DefaultWorkingDirectory']}}是工作目录路径，不是具体模板文件，需要补全到.yaml后缀的具体模板文件地址，比如${{variables['System.DefaultWorkingDirectory']}}/deploy/component.yaml
2. 修改被引用模板的内容，新增重试参数并绑定到内部任务：

# 被引用的模板文件内容
parameters:
- name: Test
  type: boolean
- name: Environment
  type: string
- name: Component
  type: string
# 新增重试相关参数，可设默认值
- name: taskRetryCount
  type: number
  default: 2
- name: retryIntervalSeconds
  type: number
  default: 5

steps: # 如果是job级模板就把下面配置放到对应job的steps下
- script: echo 你的原有任务逻辑
  # 给每个任务绑定重试配置
  retryCountOnTaskFailure: ${{ parameters.taskRetryCount }}
  delayBeforeRetry: ${{ mul(parameters.retryIntervalSeconds, 1000) }} # 单位转成毫秒
# 模板内其余所有任务都加上上面两行重试配置即可

3. 调用模板时按需传入重试参数即可，不传就用默认值：

- template: ${{variables['System.DefaultWorkingDirectory']}}/deploy/component.yaml
  parameters:
    Test: ${{ parameters.isTestRelease }}
    Environment: ${{ parameters.deploymentTarget }}
    Component: '${{ parameters.component }}'
    taskRetryCount: 3 # 失败后最多重试3次
    retryIntervalSeconds: 5 # 每次重试间隔5秒

方案2：无法修改被引用模板（外层包裹重试逻辑） #

如果你没有被引用模板的修改权限，可以把模板调用包裹在支持重试的作业单元中，做整个作业维度的重试：

jobs:
- deployment: ComponentDeploy # 普通job也支持同格式重试配置，deployment作业兼容性更好
  environment: ${{ parameters.deploymentTarget }}
  # 配置作业级重试规则
  strategy:
    retry:
      count: 3 # 失败最多重试3次
      delayBetweenRetries: PT5S # ISO8601时长格式，PT5S代表间隔5秒，PT1M代表间隔1分钟
  steps:
  # 把原有模板调用放到这个作业的steps下即可
  - template: ${{variables['System.DefaultWorkingDirectory']}}/deploy/component.yaml
    parameters:
      Test: ${{ parameters.isTestRelease }}
      Environment: ${{ parameters.deploymentTarget }}
      Component: '${{ parameters.component }}'

注意事项 #

• 不要尝试用运行时脚本循环实现模板重试：模板是编译期静态展开的内容，运行阶段不存在动态调用模板的能力，这类写法不会生效。
• 作业级重试会重跑整个作业内的所有步骤，适合模板内部步骤有幂等性的场景；如果需要更细粒度的单任务重试，优先选方案1。

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