Terraform启动脚本引号丢失致命令执行失败的解决咨询

使用Terraform在GCP上构建集群时，通过templatefile参数化配置虚拟机启动脚本（metadata_startup_script），简单命令可正常执行，但传递带空格的字符串参数时（例如foo --but-also="Value with spaces"），命令执行失败，后续命令也完全无法运行。

查看google-startup-scripts.service日志发现，引号被剥离，实际执行的命令变为：

COMMAND=/usr/bin/foo --parameter=value --but-also=Value with spaces

尝试过以下方法但均无效：

• 在脚本模板中用单引号包裹变量：foo --parameter='${value}' --but-also='${another_value}'
• 在templatefile参数中直接传递变量：

  metadata_startup_script = templatefile("sh/my_setup.sh", {
      ...
      another_value = "${var.another_value}",
      ...
    })
  

• 在templatefile参数中转义引号：

  metadata_startup_script = templatefile("sh/my_setup.sh", {
      ...
      another_value = "\"${var.another_value}\"",
      ...
    })
  

附问题脚本片段：

#!/bin/bash

# 非参数化命令
sudo apt-get update
sudo apt-get -y upgrade 
sudo apt-get -y install python3 lvm2

# ...

# 简单参数命令（正常运行）
sudo cephadm bootstrap --mon-ip ${mon_ip} --ssh-user ${ceph_username} 
sudo ceph fs volume create ${cephfs_name}
sudo ceph fs authorize ${cephfs_name} client.${ceph_client_username} / rw | sudo tee ${filesystem_key_dir}/${filesystem_key_name}

# 有问题的命令
sudo radosgw-admin user create --subuser=${rgw_username} --uid=${rgw_uid} --display-name=${rgw_user_display_name} --key-type=swift --secret=${rgw_secret} --access=full

# 后续命令（除非注释掉上面的问题命令，否则无法执行）
gcloud storage cp ${config_file_dir}/${config_file_name} gs://${bucket_name}/

核心是确保生成的Bash脚本中，含空格的变量被正确识别为单个参数，同时避免Terraform渲染时丢失必要的引号。

方法1：在模板脚本中直接给变量加双引号 #

针对可能含空格的变量，在模板里直接包裹双引号，比如修改问题中的命令：

# 修改后的问题命令
sudo radosgw-admin user create --subuser=${rgw_username} --uid=${rgw_uid} --display-name="${rgw_user_display_name}" --key-type=swift --secret="${rgw_secret}" --access=full

这种方式下，Terraform渲染后会保留双引号，Bash执行时会将带空格的内容完整识别为一个参数。

方法2：用Terraform的jsonencode函数处理特殊场景 #

如果变量中包含特殊字符（比如引号本身），可以用jsonencode函数自动完成转义，在templatefile传参时处理：

metadata_startup_script = templatefile("sh/my_setup.sh", {
    ...
    rgw_user_display_name = jsonencode(var.rgw_user_display_name),
    rgw_secret = jsonencode(var.rgw_secret),
    ...
})

此时模板脚本中无需额外加引号，直接使用变量即可：

sudo radosgw-admin user create --subuser=${rgw_username} --uid=${rgw_uid} --display-name=${rgw_user_display_name} --key-type=swift --secret=${rgw_secret} --access=full

jsonencode会自动为含空格/特殊字符的字符串添加双引号，并转义内部特殊符号，保证Bash能正确解析。

关键注意事项 #

• 不要在templatefile参数中手动添加转义引号（如"\"${var.x}\""），这种方式会导致渲染后的脚本出现多余转义，引发新问题。
• 优先使用方法1，这是最直观且不易出错的方式，适合大多数普通场景。

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