多国家数据库备份Azure YAML管道构建技术求助

1. 目录结构与变量模板文件 #

先为每个国家创建独立的变量模板文件，命名规则严格遵循[国家代码]_variables.yml：

• us_variables.yml
• eu_variables.yml
• apac_variables.yml

变量模板示例（以us_variables.yml为例）：

variables:
  agentName: 'US-Backup-Agent'
  dbServer: 'us-db-server-01'
  dbName: 'us-main-db'
  backupPath: '/backups/us/'

2. 主管道核心实现 #

通过阶段矩阵遍历国家列表，动态加载对应变量模板，在指定Agent上执行备份任务，同时配置Cron调度：

trigger: none

# Cron调度：每天凌晨2点执行备份
schedules:
- cron: '0 2 * * *'
  displayName: Daily Multi-Country DB Backup
  branches:
    include:
    - main
  always: true

parameters:
  # 定义需要备份的国家列表，可按需增减
  - name: targetCountries
    type: object
    default:
      - us
      - eu
      - apac

stages:
- ${{ each country in parameters.targetCountries }}:
  - stage: Backup_${{ country }}_DB
    displayName: Backup ${{ country | uppercase }} Database
    variables:
      # 编译时动态加载对应国家的变量模板
      - template: ${{ country }}_variables.yml
    jobs:
    - job: Execute_Backup
      displayName: Run Backup on ${{ variables.agentName }}
      pool:
        # 指定代理池，匹配变量模板中的Agent.Name
        name: 'Default' # 替换为你的代理池名称
        demands:
          - Agent.Name -equals ${{ variables.agentName }}
      steps:
      - script: |
          echo "Initiating backup for ${{ country }} database..."
          # 替换为实际数据库备份命令（如mysqldump、pg_dump、sqlcmd等）
          mysqldump -h $(dbServer) -u $(dbUser) -p$(dbPassword) $(dbName) > $(backupPath)/$(dbName)_$(Build.BuildId).sql
        displayName: 'Run Database Backup'
      - task: PublishBuildArtifacts@1
        displayName: 'Upload Backup File'
        inputs:
          pathtoPublish: '$(backupPath)/$(dbName)_$(Build.BuildId).sql'
          artifactName: '${{ country }}-db-backup-$(Build.BuildId)'

3. 关键配置说明 #

• 编译时表达式适配：Azure管道的模板引用属于编译时操作，必须用${{ country }}遍历参数列表（参数在编译时已确定），不能用运行时变量$(country)，这是动态加载模板的核心。
• 串行执行控制：默认阶段是并行执行的，如果需要按顺序处理每个国家，在阶段中添加依赖配置：

  stages:
  - ${{ each country in parameters.targetCountries }}:
    - stage: Backup_${{ country }}_DB
      displayName: Backup ${{ country | uppercase }} Database
      # 除第一个国家外，每个阶段依赖前一个国家的备份阶段
      ${{ if not(eq(indexOf(parameters.targetCountries, country), 0)) }}:
        dependsOn: Backup_${{ parameters.targetCountries[indexOf(parameters.targetCountries, country)-1] }}_DB
      # ...后续变量、作业配置不变
  

• 敏感变量处理：数据库密码等敏感信息不要硬编码，应存入Azure DevOps变量组，在变量模板中引用：

  # 示例：us_variables.yml中添加变量组引用
  variables:
  - group: 'us-db-secrets' # 提前创建包含dbUser、dbPassword的变量组
  - name: agentName
    value: 'US-Backup-Agent'
  # ...其他变量
  

4. 常见问题排查 #

• 模板加载失败：检查模板文件名与国家参数是否完全匹配（大小写敏感），确认文件在仓库路径正确。
• Agent匹配失败：核对代理的Agent.Name与变量模板中的值完全一致，代理池名称在pool.name中配置正确。
• 变量未生效：引用变量模板的值时，编译时场景用${{ variables.xxx }}，运行时场景用$(xxx)，按需选择。

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