Ansible向J2模板传递变量失败问题求助

核心问题分析 #

1. 变量文件结构错误：你用vars_files加载的config_vars.yaml采用了Inventory层级结构（all/children/hosts），但vars_files仅支持加载普通键值对格式的变量文件，这种Inventory结构只会被解析为一个名为all的字典变量，而非顶层全局/主机变量，导致模板无法直接读取my_value_one和my_value_two。
2. 模板路径不匹配：Playbook中指定的模板路径是templates/myfile.json.j2，但实际目录是playbooks/template/（单数template），路径不一致会导致Ansible找不到模板文件。
3. Inventory变量冲突：你提到在Inventory中直接定义变量输出随机数字，大概率是使用了和Ansible内置变量重名的变量（比如ansible_*前缀的自定义变量），触发了内置变量的覆盖或解析异常。

解决方案 #

方案一：修正变量文件格式（推荐） #

将vars/config_vars.yaml改为普通键值对格式，若需区分全局和主机专属变量，建议使用Ansible标准的group_vars/host_vars目录结构：

方式1：拆分变量到标准目录

1. 创建group_vars/myhosts.yaml文件（存放myhosts组的专属变量）：

# group_vars/myhosts.yaml
my_value_two: "value2"

2. 创建group_vars/all.yaml文件（存放全局共享变量）：

# group_vars/all.yaml
my_value_one: "value1"

3. 删除原vars/config_vars.yaml，Playbook中无需再配置vars_files，Ansible会自动加载group_vars和host_vars下的变量。

方式2：修改现有变量文件格式

如果坚持使用原vars_files方式，将vars/config_vars.yaml改为：

# vars/config_vars.yaml
my_value_one: "value1"
my_value_two: "value2"

方案二：将变量文件作为额外Inventory加载 #

保留原config_vars.yaml的Inventory结构，运行Playbook时将其作为额外Inventory传入，而非通过vars_files加载：

ansible-playbook -i inventory.ini -i vars/config_vars.yaml playbooks/do-something.yaml

Ansible会解析该文件为Inventory的一部分，自动加载其中的all.vars和主机专属变量。

修正模板路径 #

将Playbook中的模板路径改为实际目录对应的路径：

template:
  src: template/myfile.json.j2  # 对应playbooks/template目录
  dest: /home/{{ ansible_user }}/my-folder/myfile.json

或者将playbooks/template目录重命名为playbooks/templates，保持和路径名一致。

避免变量冲突 #

自定义变量时避免使用ansible_前缀，以及Ansible内置变量名（可通过ansible-doc -t variable all查看内置变量列表）。

验证方法 #

在Playbook中添加debug任务，确认变量是否正常加载：

tasks:
  - name: 验证全局变量
    debug:
      var: my_value_one
  - name: 验证主机变量
    debug:
      var: my_value_two
  - name: Replace file with j2 template
    template:
      src: template/myfile.json.j2
      dest: /home/{{ ansible_user }}/my-folder/myfile.json

内容的提问来源于stack exchange，提问作者The Node Guy