Ansible playbook的hosts字段引用group_vars/all.yml变量失败如何解决

问题原因 #

该报错是Ansible变量加载顺序和play解析逻辑的特性导致的，核心逻辑如下：

• Playbook的hosts字段是在play解析的最早期阶段处理的，此时仅会加载命令行传入的extra vars、Ansible配置内置变量等优先级最高的前置变量，还未加载任何和inventory关联的group_vars/host_vars变量。
• 你定义在group_vars/all/all.yml中的变量属于inventory关联变量，需要等hosts字段解析完成、确定了目标主机范围之后，才会加载对应主机/组的变量文件，因此解析hosts字段时inventory_group_name还未被加载，就会抛出未定义错误。
• 命令行通过--extra-vars传入的变量加载时间最早，因此解析hosts字段时可以正常读取；而play内的task是在所有变量加载完成后才执行的，因此debug语句可以正常读取到group_vars下定义的变量值。

注意：你现有playbook中hosts: {{ inventory_group_name }}的写法不符合YAML语法规范，变量外层需要加双引号包裹，修正为hosts: "{{ inventory_group_name }}"，否则即使变量正常加载也会抛出语法错误。

解决方案 #

可以根据使用场景选择以下任意一种方案解决：

方案1：通过extra vars加载变量（适合动态指定分组的场景） #

运行playbook时直接通过命令行传入变量，不需要修改现有playbook逻辑：

ansible-playbook your_playbook.yml -e "inventory_group_name=group1"

如果变量较多，也可以把所有变量统一存放在一个yaml文件中批量加载：

ansible-playbook your_playbook.yml -e @custom_vars.yml

方案2：双play预加载变量（不需要额外传参） #

在原有play前新增一个针对localhost的play，提前加载全局变量后再传递给第二个play使用：

- name: 预加载全局变量
  hosts: localhost
  gather_facts: no
  tasks:
    - name: 加载全局配置文件
      include_vars: group_vars/all/all.yml

- name: Check whether inventory name is picked properly
  hosts: "{{ hostvars['localhost']['inventory_group_name'] }}"
  tasks:
    - name: Debug statement
      debug:
        msg: "{{ inventory_group_name }}"

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