如何在EC2的PowerShell脚本中访问Terraform传入的user-data变量

Terraform的template_file数据源是模板渲染工具，不会自动将定义的vars作为命令行参数传递给EC2上执行的PowerShell脚本。通过param、args无法获取值的核心原因是：PowerShell模板文件中没有配置对应占位符，Terraform没有将变量值注入到最终生成的user-data内容中。

• 第一步：修改PowerShell模板文件
  打开user-data/user-data-software.ps1，使用Terraform模板插值语法${变量名}定义占位符，渲染阶段Terraform会直接将占位符替换为实际变量值。注意：脚本中PowerShell原生的$变量需要写成$$做转义，避免被模板引擎误解析；Windows user-data中的PowerShell代码需要包裹在<powershell>标签内才能被正常执行。
  模板参考示例：

  <powershell>
  # Terraform注入的变量，占位符会在渲染时被替换为实际值
  $aws_region = "${aws_region}"
  $bucket_key = "${bucket_key}"
  $bucket_sim_files = "${bucket_sim_files}"
  
  # 以下为原有安装逻辑，可直接调用上述变量
  Write-Host "当前部署区域: $aws_region"
  Write-Host "存储桶1名称: $bucket_key"
  Write-Host "存储桶2名称: $bucket_sim_files"
  
  # 后续软件安装逻辑...
  </powershell>
  

  如果传入的变量值包含引号、$等PowerShell特殊字符，可以用jsonencode()包裹变量避免语法错误，写法为$bucket_key = ${jsonencode(bucket_key)}，Terraform会自动完成特殊字符转义。

• 第二步：正确引用渲染后的模板内容
  确认EC2实例资源的user_data字段引用的是模板渲染后的结果，不要直接读取原始PowerShell文件，参考配置：

  resource "aws_instance" "windows_app" {
    # 其余EC2配置（机型、镜像、安全组等）省略
    user_data = data.template_file.template_name.rendered
  }
  

  如果写成user_data = file("user-data/user-data-software.ps1")会直接加载未替换变量的原始脚本，永远拿不到传入的值。

• 第三步：验证注入结果
  执行terraform plan时可以在输出中查看user_data的渲染结果，确认占位符已经被替换为实际值。实例启动后也可以登录机器直接检查脚本文件：

  • 启动日志路径：C:\ProgramData\Amazon\EC2-Windows\Launch\Log\UserdataExecution.log
  • 实际执行的脚本路径：C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\UserScript.ps1
    打开脚本文件即可确认变量值是否正确注入。

• 不要尝试通过param、args接收自定义变量：EC2的user-data由系统Agent自动调用执行，不会传递自定义命令行参数，所有环境差异值必须在Terraform渲染阶段直接写入脚本内容。
• 新旧版本Launch Agent的脚本路径略有差异，如果在上述路径找不到文件，可以直接在C盘搜索UserScript.ps1定位。
• 注意区分变量注入问题和权限问题：user-data默认以System账号执行，如果脚本运行中出现资源访问被拒绝的报错，和变量传参无关，需要单独调整权限。

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