修复Azure DevOps流水线中模板调用条件异常问题

问题背景 #

• 使用YAML模板流水线将构建镜像部署至Kubernetes环境，分支部署规则：
  • main分支：部署到Development和QC环境
  • release/*分支：依次部署到Test、Production、Contingency环境（Contingency预期与Production使用同一镜像）
• 现有核心阶段配置：

  - template: deploy-pipeline-job-template.yml
    parameters:
      canRun: and(not(or(failed(), canceled())), startsWith(variables['resources.pipeline.buildPipeline.sourceBranch'], 'refs/heads/release/'))
      stageName: Test
      variableGroup: myproj-web-variables-test
      buildPipelineId: ${{ parameters.buildPipelineId }}
      devOpsEnvironment: myproj-test
      kubernetesServiceConnection: myproj-dev-kubeconfig
  - template: deploy-pipeline-job-template.yml
    parameters:
      canRun: and(not(or(failed(), canceled())), startsWith(variables['resources.pipeline.buildPipeline.sourceBranch'], 'refs/heads/release/'))
      stageName: Production
      variableGroup: myproj-web-variables-prod
      buildPipelineId: ${{ parameters.buildPipelineId }}
      devOpsEnvironment: myproj-prod
      kubernetesServiceConnection: myproj-prod-kubeconfig
  - template: deploy-pipeline-job-template.yml
    parameters:
      canRun: and(not(or(failed(), canceled())), startsWith(variables['resources.pipeline.buildPipeline.sourceBranch'], 'refs/heads/release/'))
      stageName: Contingency
      variableGroup: myproj-web-variables-cont
      buildPipelineId: ${{ parameters.buildPipelineId }}
      devOpsEnvironment: myproj-cont
      kubernetesServiceConnection: myproj-cont-kubeconfig
  

• 审批规则：QC、Test、Production阶段需人工审批，预期逻辑为：
  • Production审批通过：同时部署Production和Contingency
  • Production未审批（含审批过期）：两者都不部署
• 异常现象：Production审批等待30天过期后，Production阶段未部署，但Contingency自动触发部署，导致环境不一致。

问题原因 #

当前canRun参数仅排除了流水线失败（failed()）、取消（canceled()）的情况，但Production审批过期后，该阶段的状态为skipped（不属于failed/canceled范畴），因此Contingency的canRun条件依然成立，触发了不必要的部署。

解决方案 #

修改Contingency阶段的canRun参数，增加对Production阶段成功状态的依赖，确保只有Production阶段成功完成（审批通过且部署成功）时，Contingency才会执行。

修改后的Contingency阶段配置：

- template: deploy-pipeline-job-template.yml
  parameters:
    canRun: and(not(or(failed(), canceled())), startsWith(variables['resources.pipeline.buildPipeline.sourceBranch'], 'refs/heads/release/'), succeeded('Production'))
    stageName: Contingency
    variableGroup: myproj-web-variables-cont
    buildPipelineId: ${{ parameters.buildPipelineId }}
    devOpsEnvironment: myproj-cont
    kubernetesServiceConnection: myproj-cont-kubeconfig

关键说明 #

• succeeded('Production')：指定判断Production阶段的状态，只有当该阶段成功完成时，此条件才为真。
  • 若Production因审批过期被跳过、部署失败或流水线被取消，succeeded('Production')会返回false，Contingency的canRun条件不满足，不会触发部署。
  • 无需给Contingency添加额外审批步骤，仅通过状态依赖即可实现预期逻辑。

内容的提问来源于stack exchange，提问作者Green Grasso Holm