调用Ansible SNS发布剧本遇snsTopicName变量未定义错误求助

首先，你的报错核心是**snsTopicName变量未定义**，虽然你在shell脚本里尝试传递这个变量，但大概率是变量传递环节出了问题，我们逐一排查并解决：

1. 先确认Shell脚本中snsTopicName变量本身有值 #

在调用Ansible的shell脚本里，你传递了$snsTopicName，但如果这个变量在当前shell环境中根本没被定义或赋值，那传递给Ansible的就是空值，自然会触发"变量未定义"的错误。

验证方法：在脚本开头加一行调试输出，看看变量实际值：

echo "当前snsTopicName的值是: $snsTopicName"

如果输出为空，说明你需要先确保这个变量能拿到正确的ARN值——比如从Jenkins构建参数、环境变量或其他前置步骤中获取并赋值。

2. 修复--extra-vars的传递格式（适配含冒号的ARN） #

你的SNS Topic ARN包含冒号（比如arn:aws:sns:us-east-1:123456789012:my-topic），用空格分隔的键值对格式传递--extra-vars时，shell对特殊字符的解析容易出问题。

解决方案：改用JSON格式传递额外变量，彻底避免特殊字符的解析冲突：

# 替换原脚本中--extra-vars的部分，用JSON格式传递
--extra-vars '{
  "environment": "'"$environment"'",
  "snsTopicName": "'"$snsTopicName"'"
}'

也可以用紧凑的单行写法：

--extra-vars '{"environment":"'"$environment"'","snsTopicName":"'"$snsTopicName"'"}'

这种方式能确保ARN里的冒号、斜杠等特殊字符被完整传递到Ansible中。

3. 优化Playbook的细节（避免潜在问题） #

虽然当前报错和Playbook语法无关，但可以做小优化规避后续风险：

• 在name字段中用引号包裹变量引用，避免特殊字符干扰：

  - name: "Publish Jenkins Error to SNS topic {{ snsTopicName }}"
    sns:
      msg: "Error happened when running the pipeline"
      subject: "Jenkins Error"
      topic: "{{ snsTopicName }}"
      aws_access_key: "{{ assumed_role.sts_creds.access_key }}"
      aws_secret_key: "{{ assumed_role.sts_creds.secret_key }}"
      region: "us-east-1"
  

• 顺便确认assumed_role.sts_creds相关变量已正确定义（当前报错不涉及，但提前排查后续可能的问题）。

快速验证步骤 #

1. 先在shell中手动赋值测试：

   export snsTopicName="arn:aws:sns:us-east-1:123456789012:my-test-topic"
   

2. 直接运行Ansible命令看是否还报错：

   ansible-playbook -vvv -c local sns-publish.yml --extra-vars '{"environment":"QA","snsTopicName":"'"$snsTopicName"'"}'
   

其实Ansible的sns模块完全支持带冒号的ARN，只要变量正确传递就能识别，所以问题根源和SNS组件解析冒号无关，重点在变量传递环节。

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