Azure DevOps CI/CD：将YAML环境变量传入JSON模板的方法

你遇到的核心问题是变量解析时机不匹配：

• 用##vso[task.setvariable]设置的server是运行时变量，仅在流水线任务执行过程中生成
• ${{ variables.server }}是编译时变量引用，会在流水线初始化阶段就解析，此时server变量还未被设置，因此无法直接生效

以下是两种可行的实现方案：

方案一：PowerShell脚本替换文件占位符 #

1. 修改template.json，将原有的${{ variables.server }}替换为自定义占位符（比如__SERVER_PLACEHOLDER__）：

{
    "parameters": {
        "LinkedService_connectionString": {
            "value": "__SERVER_PLACEHOLDER__"
        }
    }
}

2. 在执行build.yaml的PowerShell任务之后，新增一个PowerShell任务完成占位符替换：

# 读取template.json内容，将占位符替换为运行时的server变量值，再写回文件
(Get-Content ./template.json) -replace '__SERVER_PLACEHOLDER__', '$(server)' | Set-Content ./template.json

3. 后续流水线任务直接使用修改后的template.json即可，此时文件中的值已替换为对应服务器地址。

方案二：利用Azure DevOps File Transform任务 #

1. 修改template.json的value字段为$(server)：

{
    "parameters": {
        "LinkedService_connectionString": {
            "value": "$(server)"
        }
    }
}

2. 在流水线中添加File Transform任务，配置如下：
   • 选择JSON作为变换类型
   • 指定template.json的文件路径
   • 启用Variable Substitution选项，Azure DevOps会自动将流水线中已存在的server变量值替换到JSON文件对应位置

关键注意事项 #

• 引用运行时变量必须用$(server)格式，而非${{ variables.server }}——后者仅适用于编译时已存在的变量（如流水线预定义变量、手动设置的变量组）
• 确保执行build.yaml的任务与后续替换任务在同一个作业内，因为##vso设置的变量默认仅在当前作业有效（跨作业需添加isoutput=true参数）

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