如何用azure-pipeline.yml在Azure DevOps触发DEV/SIT/UAT多环境部署

不要把环境判断逻辑零散写在各个部署步骤的shell脚本里，直接用Azure Pipelines原生的模板表达式做编译期环境映射，单文件就能覆盖所有环境的自动识别部署，稳定性和可维护性比堆shell if判断高很多。

1. 先配置明确的触发规则 #

从源头限定可以触发管道的分支、标签范围，避免无关提交误触发部署流程：

trigger:
  branches:
    include:
      - develop    # DEV环境触发分支
      - release/*  # SIT环境触发分支（按需配置）
      - main       # PROD环境触发分支（按需配置）
  tags:
    include:
      - RC-SIT-*   # SIT环境触发标签
      - RC-UAT-*   # UAT环境触发标签

2. 全局变量层做环境自动映射 #

在YAML的变量块用模板表达式写匹配逻辑，管道启动时就会自动根据触发源计算好目标环境、命名空间等全局变量，所有后续部署步骤可以直接复用，不需要在脚本里重复赋值判断：

variables:
  # 从内置变量提取当前触发的分支/标签名，不需要手动在脚本里解析
  - name: CURRENT_BRANCH
    value: ${{ replace(variables['Build.SourceBranch'], 'refs/heads/', '') }}
  - name: CURRENT_TAG
    value: ${{ replace(variables['Build.SourceBranch'], 'refs/tags/', '') }}

  # 核心环境匹配规则，和原有if elif逻辑完全对齐，新增环境直接在这里加规则即可
  - name: TARGET_ENV
    ${{ if eq(variables['CURRENT_BRANCH'], 'develop') }}:
      value: 'app-dev'
    ${{ elseif startsWith(variables['CURRENT_BRANCH'], 'release/') }}:
      value: 'app-sit'
    ${{ elseif startsWith(variables['CURRENT_TAG'], 'RC-UAT-') }}:
      value: 'app-uat'
    ${{ elseif eq(variables['CURRENT_BRANCH'], 'main') }}:
      value: 'app-prod'
    # 兜底规则，不匹配任何预设规则时标记为无效环境
    ${{ else }}:
      value: 'invalid'

  # 命名空间默认和环境名一致，有特殊命名规则直接调整映射即可
  - name: TARGET_NS
    value: ${{ variables.TARGET_ENV }}

3. 前置校验拦截无效部署 #

在所有部署步骤前加环境合法性校验，匹配到无效触发源直接终止管道，避免误部署：

steps:
  - checkout: self

  - script: |
      if [ "$(TARGET_ENV)" = "invalid" ]; then
        echo "##vso[task.logissue type=error]当前触发源[分支:$(CURRENT_BRANCH) 标签:$(CURRENT_TAG)]不匹配任何部署规则，管道终止"
        exit 1
      fi
      echo "部署目标确认 => 环境:$(TARGET_ENV) 命名空间:$(TARGET_NS)"
    displayName: 校验部署环境合法性

  # 后续原有部署步骤保持不变，直接用$(TARGET_ENV)、$(TARGET_NS)变量即可

方案优势 #

• 稳定性更高：模板表达式在管道编译阶段就完成计算，不依赖运行Agent的shell环境，不会出现脚本内变量取值失败、判断逻辑不生效的问题
• 维护成本更低：所有环境匹配规则集中管理，调整分支/标签和环境的映射关系时，不需要翻找各个部署脚本里零散的if判断
• 容错性更好：兜底校验规则会拦截所有非预设的触发源，从流程上避免测试分支、临时标签误触发生产环境部署的事故
• 扩展性更强：后续需要给不同环境配置差异化参数（比如集群连接地址、镜像仓库路径、配置文件路径），直接在变量块对应环境的分支下新增配置即可，部署步骤全复用，不需要重复写多套部署逻辑

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