向Azure DevOps YAML流水线传递变量组变量时出现意外错误如何解决

问题根因 #

你的报错核心是令牌替换任务未生效，所有#{xxx}#格式的占位符没有被替换成变量组的实际值，导致Terraform直接把占位符字符串当成资源名称校验、调用Azure API，才触发了非法字符和资源不存在的报错。
导致替换任务失效的直接错误有3个：

• 替换目标文件配置错误：你在YAML中指定的替换目标是variables.tfvars，但你实际存放变量的文件是terraform.tfvars，任务根本没有扫描到你要替换的文件
• YAML配置缩进错误：encoding参数错误缩进在targetFiles的多行值范围内，会被系统识别为targetFiles的内容，导致整个任务的参数解析异常
• 令牌匹配规则配置错误：tokenPattern参数值错误，你填写的#{MyVar}#会被任务识别为仅匹配名为MyVar的令牌，无法匹配你配置的resource_group_name、vnet_name等其他变量令牌

修复方案 #

1. 修正替换令牌任务的YAML配置 #

正确配置如下：

displayName: 'Replace Secrets'
inputs:
  targetFiles: 'terraform.tfvars'
  encoding: 'utf-8'
  actionOnMissing: 'fail'
  tokenPattern: '#{*}#'

如果需要匹配多个文件，targetFiles可以写成多行格式，注意所有参数和targetFiles平级缩进：

displayName: 'Replace Secrets'
inputs:
  targetFiles: |
    terraform.tfvars
    other-file.tfvars
  encoding: 'utf-8'
  actionOnMissing: 'fail'
  tokenPattern: '#{*}#'

2. 增加调试步骤验证替换结果 #

在替换令牌任务之后、执行terraform plan之前，增加一个脚本任务输出terraform.tfvars的内容，确认所有占位符都被替换成了实际值：

- task: Bash@3
  displayName: 'Verify variable replacement'
  inputs:
    targetType: 'inline'
    script: 'cat terraform.tfvars'

3. 确认变量组关联 #

确保你在流水线的YAML或者UI配置中已经关联了对应的变量组，否则任务无法读取到变量值：
YAML中关联变量组的配置示例：

variables:
- group: <你的变量组名称>

额外注意事项 #

• 检查变量组中的变量名称是否和tfvars文件中的占位符名称完全一致，大小写敏感
• 如果变量设置为保密变量，替换任务默认支持读取保密变量值，不需要额外配置

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