如何通过Terraform templatefile为EC2的user_data传递环境变量？脚本执行异常问题咨询

首先得明确：你当前的写法其实只是完成了字符串替换，算不上真正“设置环境变量”，而且如果密码包含特殊字符（比如$、空格、引号），很容易导致脚本执行异常，这大概率是你遇到问题的原因。

为什么原方式存在问题？ #

你用templatefile直接替换脚本里的$password，本质是把脚本内容中的$password字符串替换成你传入的密码值。比如密码是myPass123，最终生成的脚本会变成：

#! /bin/bash
echo myPass123
# Continue to some procedures

这种情况下echo能正常输出，但如果后续步骤依赖环境变量$password，这个变量其实根本没被定义——你只是直接写入了值，没有通过export来声明环境变量。另外，如果密码里包含shell特殊字符（比如$test、"pass"），替换后会被shell错误解析，直接导致脚本执行失败。

正确的传递方式 #

要在user_data脚本中安全设置环境变量，推荐以下两种方式：

1. 修改脚本模板，先export环境变量

把你的myscript.sh改成带模板占位符的形式，先通过export定义环境变量：

#! /bin/bash
# 用双引号包裹占位符，避免特殊字符被shell错误解析
export password="${password}"
echo $password
# 后续依赖环境变量的步骤就可以直接使用$password了
# Continue to some procedures

Terraform代码保持不变：

resource "aws_instance" "web" {
  ami           = data.aws_ssm_parameter.amzn2_ami.value
  instance_type = "t2.micro"
  key_name      = aws_key_pair.key_pair.key_name
  user_data     = templatefile("./scripts/myscript.sh", { password = "********" })
}

这种方式会在脚本运行时把password设为当前shell会话的环境变量，后续脚本步骤都能直接调用。

2. 持久化环境变量（登录实例后仍可使用）

如果希望后续登录实例的会话也能访问这个环境变量，可以把变量写入系统全局配置文件：
修改myscript.sh：

#! /bin/bash
# 写入/etc/profile，所有用户登录都能加载这个变量
echo 'export password="${password}"' >> /etc/profile
# 让当前脚本会话立即生效环境变量
source /etc/profile
echo $password
# Continue to some procedures

额外排查建议 #

如果脚本还是无法正常运行，你可以通过以下方式定位问题：

• 查看cloud-init执行日志：登录实例后查看/var/log/cloud-init-output.log，里面会记录user_data脚本的执行过程和报错信息；
• 检查生成的脚本内容：实例内的/var/lib/cloud/instance/scripts/part-001就是最终执行的脚本，你可以核对是否和预期一致；
• 手动测试脚本：把生成的脚本内容复制出来手动执行，看是否有明确的报错提示。

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