如何在Azure Pipelines中按定义环境重复执行步骤并替换文件占位符？

核心思路是用Azure Pipeline的**矩阵作业（Matrix Jobs）**批量生成多环境运行实例，同时结合官方文件替换任务或脚本完成占位符替换，具体步骤如下：

1. 定义多环境变量矩阵 #

在YAML配置里用strategy.matrix定义所有目标环境，每个环境对应一套专属变量值：

jobs:
- job: RunPerEnvironment
  strategy:
    matrix:
      Development:
        EnvName: 'dev'
        ApiUrl: 'https://dev-api.example.com'
        DatabaseConn: 'Server=dev-db;Database=AppDev;'
      Staging:
        EnvName: 'staging'
        ApiUrl: 'https://staging-api.example.com'
        DatabaseConn: 'Server=staging-db;Database=AppStaging;'
      Production:
        EnvName: 'prod'
        ApiUrl: 'https://api.example.com'
        DatabaseConn: 'Server=prod-db;Database=AppProd;'

矩阵里的每个环境会自动触发一个独立的作业实例，并加载对应变量。

2. 复用步骤完成多环境运行 #

把需要重复执行的步骤（比如占位符替换、部署操作）放到这个作业下，每个环境实例都会自动执行这些步骤，无需手动复制代码。

3. 文件占位符替换 #

根据配置文件格式选择对应替换方式：

方式一：官方File Transform任务（适合JSON/XML/YAML） #

如果配置文件是结构化格式（比如appsettings.json），直接用官方任务自动替换：
假设配置文件占位符用#{变量名}#格式：

{
  "ApiBaseUrl": "#{ApiUrl}#",
  "DatabaseConnectionString": "#{DatabaseConn}#"
}

在作业中添加任务：

steps:
- task: FileTransform@1
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/your-app-dir'
    fileType: 'json'
    targetFiles: 'appsettings.json'

任务会自动将占位符替换为当前环境的变量值。

方式二：脚本替换（适合任意文本文件） #

如果是普通文本文件，用PowerShell或Bash脚本处理，比如PowerShell示例：

steps:
- powershell: |
    $configFile = "$(Build.SourcesDirectory)/config.ini"
    # 替换占位符
    (Get-Content $configFile) -replace 'API_URL_PLACEHOLDER', '$(ApiUrl)' `
                               -replace 'DB_CONN_PLACEHOLDER', '$(DatabaseConn)' | Set-Content $configFile
  displayName: 'Replace placeholders in config'

完整示例YAML #

trigger:
- main

jobs:
- job: ProcessEnvironments
  strategy:
    matrix:
      Dev:
        Env: 'dev'
        ApiUrl: 'https://dev-api.example.com'
        DbConn: 'Server=dev-db;Db=AppDev;'
      Staging:
        Env: 'staging'
        ApiUrl: 'https://staging-api.example.com'
        DbConn: 'Server=staging-db;Db=AppStaging;'
      Prod:
        Env: 'prod'
        ApiUrl: 'https://api.example.com'
        DbConn: 'Server=prod-db;Db=AppProd;'

  steps:
  - checkout: self

  # 替换JSON配置文件占位符
  - task: FileTransform@1
    inputs:
      folderPath: '$(Build.SourcesDirectory)/src'
      fileType: 'json'
      targetFiles: 'appsettings.json'

  # 执行后续操作（比如部署到对应环境）
  - script: echo "Deploying to $(Env) environment, API URL: $(ApiUrl)"
    displayName: 'Deploy to $(Env)'

为什么这是最直接的方式？ #

• 矩阵作业自动生成多环境实例，无需手动复制步骤，维护成本低
• 变量集中管理，修改环境配置仅需更新矩阵定义
• 官方任务或脚本覆盖所有文件格式场景，灵活度高

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