如何为多个build artifacts创建通用YAML发布流水线

前置约束约定 #

所有Build Definition必须遵循统一的命名和制品结构规范是这套通用Pipeline能落地的核心前提，需要先对齐以下规则：

• 所有Build Definition命名统一采用{模块名}-build的格式，生成的制品名统一为{模块名}-artifacts
• 制品内部目录结构固定：部署配置文件存放在/deploy路径、可执行文件/静态资源存放在/release路径，避免不同模块路径不统一导致部署失败
• 各模块的差异化配置（如环境密钥、资源标识等）统一存入公共变量组，禁止硬编码在部署逻辑中
• 不同模块的专属部署步骤以{模块名}-deploy-steps.yml的命名规则存放在统一的模板目录中

核心Pipeline实现 #

以下是完整的通用Pipeline样例，可直接按需调整参数使用：

# 通用Release Pipeline 入口文件
trigger: none # 支持设置为Build完成自动触发，或保留手动触发模式
variables:
  # 引用公共变量组，存储所有模块通用的配置、认证信息等
  - group: common-release-config
  # 运行时可选择的参数，无需修改代码即可切换发布对象和环境
  - name: targetModule
    displayName: "待发布模块"
    values:
    - module-user
    - module-goods
    - module-order
  - name: targetEnv
    displayName: "目标部署环境"
    values:
    - dev
    - test
    - uat
    - prod

resources:
  pipelines:
  # 动态关联对应模块的Build Definition
  - pipeline: moduleBuildSource
    source: ${{ variables.targetModule }}-build
    # 开启后对应模块Build运行成功会自动触发该Release Pipeline
    trigger:
      branches:
        include:
        - main

stages:
# 阶段1：拉取对应Build生成的制品
- stage: FetchArtifacts
  jobs:
  - job: DownloadBuildArtifacts
    steps:
    - task: DownloadPipelineArtifact@2
      inputs:
        buildType: 'specific'
        project: '$(System.TeamProject)'
        definition: '$(targetModule)-build'
        buildVersionToDownload: 'latest'
        artifactName: '$(targetModule)-artifacts'
        downloadPath: '$(System.ArtifactsDirectory)/$(targetModule)'

# 阶段2：执行部署
- stage: RunDeployment
  dependsOn: FetchArtifacts
  jobs:
  - deployment: DeployToTargetEnv
    environment: $(targetEnv)
    strategy:
      runOnce:
        deploy:
          steps:
          # 加载对应模块的专属部署模板，传入通用参数
          - template: ./deploy-templates/$(targetModule)-deploy-steps.yml
            parameters:
              artifactLocalPath: '$(System.ArtifactsDirectory)/$(targetModule)'
              targetEnv: $(targetEnv)
              buildVersion: '$(resources.pipeline.moduleBuildSource.runName)'
          # 通用后置步骤：所有模块部署完成后统一执行健康检查、结果通知
          - script: |
              echo "模块：$(targetModule) 版本：$(buildVersion) 已成功部署至$(targetEnv)环境"
            displayName: 部署结果上报

新模块接入流程 #

新模块接入无需修改主Pipeline的核心逻辑，仅需完成3步操作：

1. 按照前置约束的命名规则创建模块对应的Build Definition，生成符合结构要求的制品
2. 在deploy-templates目录下新增该模块对应的部署步骤模板文件
3. 在入口Pipeline的targetModule可选值列表中添加新模块名称，如有特殊配置同步更新到公共变量组即可

可选优化方向 #

• 新增制品校验步骤：拉取制品后校验哈希值、版本标识是否符合预期，避免部署错误版本
• 新增灰度发布逻辑：根据模块配置自动匹配放量规则，支持分批部署、流量切分
• 新增自动审批逻辑：根据环境、模块等级自动匹配审批流程，无需为每个模块单独配置审批规则

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